Restofy Docs
Facturación de ventas 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. Incluye los documentos vinculados: el que esta factura anula o reemplaza, y el que la anuló o la reemplazó. 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://restofy.pro/api/invoicing/get-invoice \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "invoiceUuid": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "invoiceUuid": "4f1da098-ab4a-11f1-b72d-f2569efa6eee"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "invoice": {
            "invoiceUuid": "4f1da098-ab4a-11f1-b72d-f2569efa6eee",
            "invoiceNumber": "F0002",
            "consecutive": 2,
            "prefix": "F",
            "issueDate": "2026-09-08T16:32:10.000Z",
            "dueDate": null,
            "documentTypeName": "Factura POS",
            "documentTypeCode": "doc.pos",
            "documentKind": "invoice",
            "isElectronic": 0,
            "transmissionStatus": "pending",
            "transmittedAt": null,
            "acceptedAt": null,
            "providerCode": null,
            "orderCode": "56C-D53",
            "orderUuid": "8dc2f67b-a4d2-40a0-8101-f886156b04ee",
            "actorName": "App Testing",
            "recipientName": null,
            "recipientDocumentNumber": null,
            "recipientDocumentTypeName": null,
            "recipientOrganizationTypeName": null,
            "recipientTaxRegimeName": null,
            "recipientFiscalAddress": null,
            "recipientEmail": null,
            "totalBaseCents": 4600000,
            "discountCents": 0,
            "taxCents": 0,
            "priceCents": 4600000,
            "grandTotalCents": 4600000,
            "tipAmountCents": 0,
            "tipModeApplied": "disabled",
            "deliveryFeeCents": 0,
            "deliveryModeApplied": "disabled",
            "cufe": null,
            "externalUrl": null,
            "providerReference": null,
            "transmissionMetadata": null,
            "creditNoteConceptName": null,
            "creditNoteReason": null,
            "recipientMunicipalityName": null,
            "relatedInvoiceUuid": null,
            "relatedInvoiceNumber": null,
            "reversedByInvoiceUuid": null,
            "reversedByInvoiceNumber": null,
            "replacedByInvoiceUuid": null,
            "replacedByInvoiceNumber": null,
            "sequenceSelectionMode": "manual",
            "sequenceName": "Secuencia POS",
            "sequencePrefix": "F",
            "sequenceSuffix": null,
            "sequencePaddingLength": 4,
            "sequenceCurrentValue": 2,
            "sequenceStartValue": 1,
            "sequenceMinValue": 1,
            "sequenceMaxValue": 99999,
            "sequenceIncrement": 1,
            "taxResolutionNumber": null,
            "taxResolutionDate": null,
            "sequenceValidFrom": null,
            "sequenceValidTo": null,
            "sequenceStatus": "active",
            "cashRegisterName": "Caja Principal",
            "providerName": null,
            "providerTypeName": null,
            "providerCountryCode": null,
            "transmissionErrors": []
        },
        "items": [
            {
                "description": "Cazuela de Mariscos",
                "quantity": "1.0000",
                "unitPriceCents": 2300000,
                "discountCents": 0,
                "totalBaseCents": 2300000,
                "taxCents": 0,
                "priceCents": 2300000,
                "modifiersTotalCents": 0
            },
            {
                "description": "Cazuela de Mariscos",
                "quantity": "1.0000",
                "unitPriceCents": 2300000,
                "discountCents": 0,
                "totalBaseCents": 2300000,
                "taxCents": 0,
                "priceCents": 2300000,
                "modifiersTotalCents": 0
            }
        ],
        "annullingCreditNote": null
    }
}