Crear una nota de crédito de forma simplificada

Descripción

Este endpoint permite crear una nota de crédito de forma rápida y sencilla, enviando los datos del documento asociado y los productos incluidos en la nota de crédito.

La nota de crédito debe estar asociada a un documento previamente registrado, como una factura. Puedes identificar la factura asociada mediante su referencia en la API.

Si alguno de los productos no existe, la API podrá crearlo automáticamente según su configuración.

También puedes indicar si deseas enviar la nota de crédito al SIFEN para su autorización mediante el campo send.

Endpoint

POST /api/credit_notes

Autenticación

Este endpoint requiere autenticación mediante un token Bearer.

Incluye el siguiente encabezado en la solicitud:

Authorization: Bearer TU_TOKEN

Cuerpo de la solicitud

Envía los datos de la nota de crédito en formato JSON.

Ejemplo de JSON

{
    "emitDate": "2026-10-09 19:09:00",
    "motivo": 1,
    "documentAssociated": {
        "tipoDocumento": 1,
        "descTipoDocumento": "Electrónico",
        "invoice": "/api/invoices/218"
    },
    "invoiceDetails": [
        {
            "product": {
                "name": "new from api",
                "sku": "napi1",
                "price": "3.56",
                "tax": "/api/taxes/1"
            },
            "amount": "3",
            "discount": "0",
            "discountType": null
        },
        {
            "product": {
                "name": "new from api 3",
                "sku": "napi1253",
                "price": "5",
                "tax": null
            },
            "amount": "5",
            "discount": "0",
            "discountType": null
        }
    ],
    "send": true
}

Descripción de los campos

Campos principales

Campo	Tipo	Descripción
`emitDate`	`string`	Fecha y hora de emisión de la nota de crédito. En el ejemplo se utiliza el formato `YYYY-MM-DD HH:mm:ss`.
`motivo`	`integer`	Código del motivo de emisión de la nota de crédito. En el ejemplo se utiliza `1`.
`documentAssociated`	`object`	Información del documento al que está asociada la nota de crédito.
`invoiceDetails`	`array`	Lista de productos y cantidades incluidos en la nota de crédito.
`send`	`boolean`	Indica si se debe solicitar el envío de la nota de crédito al SIFEN. `true` solicita el envío; `false` no lo solicita en esta operación.

Campos de `documentAssociated`

Este objeto identifica el documento original al que hace referencia la nota de crédito.

Campo	Tipo	Descripción
`tipoDocumento`	`integer`	Código del tipo de documento asociado. En el ejemplo se utiliza `1`.
`descTipoDocumento`	`string`	Descripción del tipo de documento asociado. En el ejemplo, `Electrónico`.
`invoice`	`string`	Referencia al recurso de la factura asociada. Por ejemplo, `/api/invoices/218`.

Campos de `invoiceDetails`

Cada elemento del arreglo representa una línea de la nota de crédito.

Campo	Tipo	Descripción
`product`	`object`	Datos del producto incluido en la línea.
`amount`	`string`	Cantidad de unidades del producto.
`discount`	`string`	Valor del descuento aplicado a la línea.
`discountType`	`string` o `null`	Tipo de descuento aplicado. Puede ser `null` cuando no se especifica un tipo.

Campos de `invoiceDetails[].product`

Campo	Tipo	Descripción
`name`	`string`	Nombre o descripción del producto.
`sku`	`string`	Código o referencia utilizada para identificar el producto.
`price`	`string`	Precio unitario del producto.
`tax`	`string` o `null`	Referencia al impuesto asociado al producto, por ejemplo, `/api/taxes/1`. Puede ser `null` si no se asigna un impuesto y la API lo permite.

Envío de la nota de crédito al SIFEN

El campo send permite indicar si deseas enviar la nota de crédito al Sistema Integrado de Facturación Electrónica Nacional (SIFEN).

Valor	Comportamiento
`true`	Solicita el envío de la nota de crédito al SIFEN para su autorización.
`false`	No solicita el envío al SIFEN durante esta operación.

La solicitud de envío no garantiza la autorización del documento. El resultado depende de las validaciones y de la respuesta del SIFEN.

Ejemplo de respuesta

La siguiente respuesta muestra una nota de crédito creada correctamente cuyo documento electrónico se encuentra en proceso de autorización.

{
    "@context": "/api/contexts/CreditNote",
    "@id": "/api/credit_notes/25",
    "@type": "CreditNote",
    "id": 25,
    "emitDate": "2026-10-09T19:09:00-03:00",
    "total": "36.65090909",
    "totalWithoutTax": 35.68,
    "totalDiscount": 0,
    "documentAssociated": {
        "@type": "AssociatedDocument",
        "id": 35,
        "iTipDocAso": 1,
        "descTipoDocumento": "Electrónico",
        "cdc": "01800870883001001000058422026100917915838350",
        "invoice": {
            "@type": "Invoice",
            "@id": "/api/invoices/218",
            "id": 218
        }
    },
    "iMotEmi": 1,
    "descMotivo": "Devolución y Ajuste de precios",
    "invoiceDetails": [
        {
            "id": 566,
            "product": {
                "id": 85,
                "name": "new from api",
                "sku": "napi1",
                "price": "3.56",
                "tax": {
                    "id": 1,
                    "name": "IVA 10%",
                    "amount": "10.00"
                }
            },
            "amount": 3,
            "discount": 0,
            "price": 3.56
        },
        {
            "id": 567,
            "product": {
                "id": 86,
                "name": "new from api 3",
                "sku": "napi1253",
                "price": "5"
            },
            "amount": 5,
            "discount": 0,
            "price": 5
        }
    ],
    "sriDocument": {
        "@id": "/api/sri_documents/183",
        "@type": "SriDocument",
        "id": 183,
        "claveAccesso": "05800870883001001000000622026100917915839108",
        "secuencial": "0000006",
        "estado": "EN_PROGRESO",
        "serie1": "001",
        "serie2": "001",
        "qr": "https://ekuatia.set.gov.py/consultas-test/qr?nVersion=150&Id=05800870883001001000000622026100917915839108&dFeEmiDE=323032362d31302d30395431393a30393a3030&dNumIDRec=EQ5369854&dTotGralOpe=35.68000000&dTotIVA=0.97090909&cItems=2&DigestValue=78636174756730437134532b4e4c565a7470516c514955704b6849446d4c5457713744596d465274704a303d&IdCSC=0001&cHashQR=b0a1c8e8e89eaa84d7451e3e3b4ecad0ec3a297d6ed1d01ddcbfcc27d2fa3037",
        "xml": ""
    },
    "aditionalFields": [],
    "sucursal": "/api/sucursals/12",
    "client": {
        "@id": "/api/clients/39",
        "@type": "Client",
        "id": 39,
        "razonSocial": "Mi razón social",
        "idClient": "EQ5369854",
        "typeId": "2",
        "name": "Guerby",
        "lastname": "Duval",
        "email": "[email protected]",
        "phone": "+5987154522145",
        "naturaleza": 2,
        "tipoOperacion": 2,
        "codigoPais": "PRY",
        "nombrePais": "Paraguay"
    },
    "creationDate": "2026-10-09T19:11:50-03:00",
    "dateUpdate": "2026-10-09T19:11:50-03:00"
}

Importante: el estado EN_PROGRESO indica que el documento todavía está en proceso de autorización. No significa que ya haya sido aprobado por el SIFEN.

Descripción de los campos principales de la respuesta

Campo	Tipo	Descripción
`id`	`integer`	Identificador de la nota de crédito.
`emitDate`	`string`	Fecha y hora de emisión de la nota de crédito.
`total`	`string`	Importe total de la nota de crédito.
`totalWithoutTax`	`number`	Importe total antes de impuestos, según el cálculo de la API.
`totalDiscount`	`number`	Importe total de los descuentos aplicados.
`documentAssociated`	`object`	Información del documento original asociado.
`iMotEmi`	`integer`	Código del motivo de emisión de la nota de crédito.
`descMotivo`	`string`	Descripción del motivo de emisión.
`invoiceDetails`	`array`	Detalle de los productos incluidos en la nota de crédito.
`sriDocument`	`object`	Información del documento electrónico y su estado ante el SIFEN.
`aditionalFields`	`array`	Campos adicionales asociados al documento.
`sucursal`	`string`	Referencia a la sucursal que emite el documento.
`client`	`object`	Datos del cliente asociado a la nota de crédito.
`creationDate`	`string`	Fecha y hora de creación del registro.
`dateUpdate`	`string`	Fecha y hora de la última actualización del registro.

Estados del documento electrónico

El estado del documento electrónico se encuentra dentro del objeto sriDocument, en el campo estado.

Estado	Descripción
`EN_PROGRESO`	El documento está en proceso de envío o validación ante el SIFEN.
`APROBADO`	El documento fue autorizado por el SIFEN.
`RECHAZADO`	El SIFEN rechazó el documento.

Consideraciones importantes

Incluye un token Bearer válido en el encabezado Authorization.
La nota de crédito debe referenciar el documento original correspondiente.
Comprueba que los productos, cantidades, precios e impuestos sean correctos.
Utiliza send: true cuando desees solicitar el envío de la nota de crédito al SIFEN.
Comprueba el estado de sriDocument para determinar el resultado de la autorización.
Los códigos de motivo y tipo de documento deben corresponder a los valores admitidos por la API.

Crear nota de crédito

#Crear una nota de crédito de forma simplificada

#Descripción

#Endpoint

#Autenticación

#Cuerpo de la solicitud

#Ejemplo de JSON

#Descripción de los campos

#Campos principales

#Campos de documentAssociated

#Campos de invoiceDetails

#Campos de invoiceDetails[].product

#Envío de la nota de crédito al SIFEN

#Ejemplo de respuesta

#Descripción de los campos principales de la respuesta

#Estados del documento electrónico

#Consideraciones importantes