--- title: Crear un Recibo Digital description: "El **recibo electrónico**oficial de SIFEN aun está pendiente por parte de la DNIT. No obstante FacturaSend proporciona su propia versión del recibo digital, el cual soluciona la mayoría de las necesidades internas de una Empresa. El recibo digital de FacturaSend,…" url: "https://facturasend.com.py/documentacion/crear-un-recibo-digital/" updated: "2025-06-27" category: "3-API de FacturaSend" --- # Crear un Recibo Digital El **recibo electrónico**oficial de SIFEN aun está pendiente por parte de la DNIT. No obstante FacturaSend proporciona su propia versión del recibo digital, el cual soluciona la mayoría de las necesidades internas de una Empresa. El recibo digital de FacturaSend, también ya implementa muchas de las validaciones que implementa SIFEN con otros tipos de documentos electrónicos y cumple con la estructura de XML y Firma Digital, lo cual implica que si SIFEN lo implementa más adelante, probablemente habrá muy pocas modificaciones a ser realizadas para adaptar la versión actual de FacturaSend a la versión del SIFEN El recibo queda completamente aprobado una vez enviado a FacturaSend, ya que éste no pasa a SIFEN. El CDC de un recibo digital de FacturaSend inicia con 55XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX. Cuando va a crear un recibo, puede especificar uno a varios documentos asociados, o puede no especificar ninguno. Si el Recibo posee documentos asociados, debe especificar el monto de cada documento asociado, y no es necesario informar el data.total, pues este será recalculado con la sumatoria de los montos de cada documento asociado involucrado. Si el Recibo no tiene documentos asociados, es obligatorio informar el data.total. ### Endpoint (URL) **POST**https://api.facturasend.com.py//recibo/create ### Header (Encabezado) Requiere el envío del los siguientes atributos en el encabezado | Campo | Valor | | --- | --- | | Authorization | Bearer api_key_**reemplazar_api_key** | | Content-Type | application/json; charset=utf-8 | ### Parámetros (BODY) Los parámetros para crear el Recibo Digital se envían en el cuerpo de la petición (BODY) en formato JSON. Los parámetros del Recibo Digital son los mismos que los que se utilizan para crear el documento electrónico. La estructura completa puede ser visualizada en la siguiente documentación [Estructura JSON de un DE](https://facturasend.com.py/documentacion/estructura-json-de-un-de/) Algunos ejemplos JSON para creación de recibos lo encontrará en [Ejemplo JSON de recibo digital](https://facturasend.com.py/documentacion/ejemplo-de-json-por-tipo-de-documento/#recibo-digital-con-valor-total) ### Parámetros (Query Param) También se pueden especificar algunos parámetros de consulta (Query Param) junto con la URL: | Parámetro | Requerido | Descripción | | --- | --- | --- | | xml | No | Especifique **true** para obtener en el resultado el/los XML/s generado/s en la operación. Su valor por defecto es **false**. | ### Ejemplo de llamadas - [shell](#tab-shell) - [javascript](#tab-javascript) ``` curl -X POST "https://api.facturasend.com.py//recibo/create" -H "Authorization: Bearer api_key_" -H 'Content-Type: application/json; charset=utf-8' --data-raw '{ "fecha": "2023-10-26T15:59:43", "establecimiento": 1, "punto": 1017, "numero": 3, "concepto" : "Pago de Cuota XYZ - Manzana MANDUVIRA(100.000GS), Lote 10. - Pago de Interes XYZ - Manzana MANDUVIRA, Lote 10.(50.000GS)", "total": 150000, "cliente": { "codigo": "00001", "contribuyente": false, "documentoNumero": "0", "documentoTipo": 5, "email": "", "pais": "PRY", "razonSocial": "CONSUMIDOR FINAL", "tipoOperacion": 2, "celular": "595973527155" }, "condicion": { "entregas": [ { "cambio": 0, "moneda": "PYG", "monto": 45000, "tipo": 1 } ], "tipo": 1 }, "usuario": { "cargo": "Vendedor", "documentoNumero": "0", "documentoTipo": 9, "nombre": "admin" }, "documentoAsociado": [{ "formato": 1, "cdc": "55800695631001001000000112023102610001111110", "monto": 185000, "montoRetencionIva" : 10000, "montoRetencionRenta" : 5000 }, { "formato": 2, "tipoDocumentoImpreso": 1, "timbrado": "12345678", "establecimiento": "002", "punto": "002", "numero": "0000003", "serie": null, "fecha": "2024-09-01", "monto": 186000 }] }' ``` ``` import axios from 'axios'; const data = { "fecha": "2023-10-26T15:59:43", "establecimiento": 1, "punto": 1017, "numero": 3, "concepto" : "Pago de Cuota XYZ - Manzana MANDUVIRA(100.000GS), Lote 10. - Pago de Interes XYZ - Manzana MANDUVIRA, Lote 10.(50.000GS)", "total": 150000, "cliente": { "codigo": "00001", "contribuyente": false, "documentoNumero": "0", "documentoTipo": 5, "email": "", "pais": "PRY", "razonSocial": "CONSUMIDOR FINAL", "tipoOperacion": 2, "celular": "5959735292639 }, "condicion": { "entregas": [ { "cambio": 0, "moneda": "PYG", "monto": 45000, "tipo": 1 } ], "tipo": 1 }, "usuario": { "cargo": "Vendedor", "documentoNumero": "0", "documentoTipo": 9, "nombre": "admin" }, "documentoAsociado": [{ "formato": 1, "cdc": "55800695631001001000000112023102610001111110", "monto": 185000, "montoRetencionIva" : 10000, "montoRetencionRenta" : 5000 }, { "formato": 2, "tipoDocumentoImpreso": 1, "timbrado": "12345678", "establecimiento": "002", "punto": "002", "numero": "0000003", "serie": null, "fecha": "2024-09-01", "monto": 186000 }] }; const headers = { `Authorization` : `Bearer api_key_` }; axios.post(`https://api.facturasend.com.py//recibo/create`, data, {headers} ) .then( respuesta => { console.log(respuesta); }); ``` ### Respuesta de la Petición La respuesta de la petición será la siguiente: ``` { "success" : true, "reciboList" : [{ "cdc": "55800695631001001000001612021112410311184194", "numero": "001-001-0000001", "xml": "", "estado": "Aprobado", "respuesta_codigo": "0260", "respuesta_mensaje": "Aprobado" }] } ``` La respuesta de éste Servicio: | Atributos | Tipo | Description | | --- | --- | --- | | success | boolean | **true**si no hubo errores en la transacción | | error | string | El mensaje de Error, en el caso de que el success = false. | | reciboList | array | El array con la respuesta de cada recibo procesado. Los atributos de éste array se describen en Respuesta [reciboList](#reciboList) | A continuación se detalla el contenido del objeto **reciboList**. | Atributos | Tipo | Description | | --- | --- | --- | | cdc | string | Id único de 44 dígitos, que inicia con 55 generado para el Recibo Digital | | numero | string | Número de Recibo Digital generado en formato 001-001-0000001 | | estado | string | Estado del Recibo Digital. Por lo general se obtiene el estado **2-Aprobado** | | xml (opcional) | string | El archivo **XML** generado del recibo digital. Este elemento solamente se retorna cuando se le pasa el valor *true* en el atributo *xml* como **queryParam** al crear el Recibo, ej: https://api.facturasend.com.py//lote/create?**xml=true** | ### Ejemplos de JSON de Recibos Visite la página de Ejemplos de nuestra documentación, existen 3 ejemplos diferentes de cómo puede crear recibos, Clic [AQUI](https://facturasend.com.py/documentacion/ejemplo-de-json-por-tipo-de-documento/#recibo-digital-con-valor-total) para acceder. ### Cancelación de un Recibo Digital Un recibo digital también puede ser cancelado. La forma de cancelar es muy similar al evento de cancelación de un documento electrónico, sólo cambia la URL ### Endpoint de Cancelación (URL) **POST**https://api.facturasend.com.py//recibo/evento/cancelacion ### Header de Cancelación (Encabezado) Requiere el envío del los siguientes atributos en el encabezado | Campo | Valor | | --- | --- | | Authorization | Bearer api_key_**reemplazar_api_key** | | Content-Type | `application/json; charset=utf-8` | ### Parámetros de Cancelación (BODY) ``` { "cdc": "55800695631001001000001612021112410311184194", "motivo": "Se digito erróneamente la dirección del cliente" } ``` ### Recomendaciones - No aplica ### Validaciones - No aplica