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 Sí
max:36

Ejemplo de request

curl -X POST https://restofy.pro/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-11-02T19:00:57Z
HTTP 200

Request

{
    "invoiceUuid": "897e60d2-d116-11f1-8bb6-de64ef616b7c"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "invoice": {
            "invoiceUuid": "897e60d2-d116-11f1-8bb6-de64ef616b7c",
            "invoiceNumber": "F0004",
            "consecutive": 4,
            "prefix": "F",
            "issueDate": "2026-11-02T18:34:55.000Z",
            "dueDate": null,
            "documentTypeName": "Factura POS",
            "documentTypeCode": "doc.pos",
            "documentKind": "invoice",
            "isElectronic": 0,
            "transmissionStatus": "cancelled",
            "transmittedAt": null,
            "acceptedAt": null,
            "providerCode": null,
            "orderCode": "67H-T48",
            "orderUuid": "dd60aa35-1701-4c6d-8937-54f8a14461ab",
            "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,
            "recipientStateRegion": null,
            "relatedInvoiceUuid": null,
            "relatedInvoiceNumber": null,
            "reversedByInvoiceUuid": "89d4a39b-d116-11f1-8bb6-de64ef616b7c",
            "reversedByInvoiceNumber": "NC0002",
            "replacedByInvoiceUuid": "8a09834a-d116-11f1-8bb6-de64ef616b7c",
            "replacedByInvoiceNumber": "F0005",
            "sequenceSelectionMode": "manual",
            "sequenceName": "Secuencia POS",
            "sequencePrefix": "F",
            "sequenceSuffix": null,
            "sequencePaddingLength": 4,
            "sequenceCurrentValue": 5,
            "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": {
            "invoiceUuid": "89d4a39b-d116-11f1-8bb6-de64ef616b7c",
            "invoiceNumber": "NC0002",
            "issueDate": "2026-11-02T18:34:55.000Z",
            "acceptedAt": null,
            "transmissionStatus": "pending",
            "isElectronic": 0
        }
    }
}