Restofy Docs
Facturación POST

Detalle de una factura

POST /api/invoicing/get-invoice

Descripción

Devuelve la información completa de una factura emitida, con sus datos fiscales, totales y líneas de detalle.

Detalles

Retorna la cabecera de una factura identificada por su código único, incluyendo los datos fiscales del cliente, la orden asociada, el desglose de totales y cada una de las líneas del documento. Si el código no corresponde a una factura existente, la respuesta llega sin datos de factura.

Permisos requeridos

cash.module

Request

Nombre Tipo Requerido Reglas
invoiceUuid string
max:36

Ejemplo de request

curl -X POST https://app.restofy.co/api/invoicing/get-invoice \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "invoiceUuid": "string"
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "invoiceUuid": "9b102a79-7eb3-11f1-ac02-f2368af4d8ac"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "invoice": {
            "invoiceUuid": "9b102a79-7eb3-11f1-ac02-f2368af4d8ac",
            "invoiceNumber": "F0002",
            "consecutive": 2,
            "prefix": "F",
            "issueDate": "2026-07-15T13:19:09.000Z",
            "dueDate": null,
            "documentTypeName": "Factura POS",
            "documentTypeCode": "doc.pos",
            "documentKind": "invoice",
            "isElectronic": 0,
            "transmissionStatus": "pending",
            "transmittedAt": null,
            "acceptedAt": null,
            "providerCode": null,
            "orderCode": "54D-J38",
            "orderUuid": "e7dfc302-6a7b-4bae-b1b5-164cd8c6f2a2",
            "actorName": "App Testing",
            "recipientName": null,
            "recipientDocumentNumber": null,
            "recipientDocumentTypeName": null,
            "recipientOrganizationTypeName": null,
            "recipientTaxRegimeName": null,
            "recipientFiscalAddress": null,
            "recipientEmail": null,
            "totalBaseCents": 3305758,
            "discountCents": 0,
            "taxCents": 1294242,
            "priceCents": 4600000,
            "grandTotalCents": 4600000,
            "tipAmountCents": 0,
            "tipModeApplied": "disabled",
            "deliveryFeeCents": 0,
            "deliveryModeApplied": "disabled",
            "cufe": null,
            "externalUrl": null,
            "relatedInvoiceUuid": null,
            "relatedInvoiceNumber": null,
            "reversedByInvoiceUuid": null,
            "reversedByInvoiceNumber": null
        },
        "items": [
            {
                "description": "Cazuela de Mariscos",
                "quantity": "1.0000",
                "unitPriceCents": 2300000,
                "discountCents": 0,
                "totalBaseCents": 1652879,
                "taxCents": 647121,
                "priceCents": 2300000,
                "modifiersTotalCents": 0
            },
            {
                "description": "Cazuela de Mariscos",
                "quantity": "1.0000",
                "unitPriceCents": 2300000,
                "discountCents": 0,
                "totalBaseCents": 1652879,
                "taxCents": 647121,
                "priceCents": 2300000,
                "modifiersTotalCents": 0
            }
        ]
    }
}