Restofy Docs
Facturación POST

Listado de facturas emitidas

POST /api/invoicing/list-invoices

Descripción

Devuelve el listado paginado de facturas emitidas en un rango de fechas, con totales del período y los tipos de documento para filtrar.

Detalles

Retorna las facturas emitidas por el restaurante dentro del rango de fechas consultado, paginadas y ordenables, junto con los totales del período y los tipos de documento disponibles como opciones de filtro. Permite acotar por estado de la factura, por tipo de documento y por una búsqueda de número, cliente u orden asociada.

Permisos requeridos

finance.module

Request

Nombre Tipo Requerido Reglas
search string No
max:100
transmissionStatus string No
max:20
documentTypeId int No
min_value:1
dateFrom string No
max:30
dateTo string No
max:30

Paginación

defaultLimit 25
maxLimit 100
allowedSorts issueDate, grandTotalCents, invoiceNumber, consecutive
defaultSort issueDate
defaultDir desc
withTotal true

Ejemplo de request

curl -X POST https://app.restofy.co/api/invoicing/list-invoices \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>"

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

Ejemplo de respuesta

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

Request

[]

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "invoices": [
            {
                "invoiceUuid": "9be7e415-7eb3-11f1-ac02-f2368af4d8ac",
                "invoiceNumber": "F0002",
                "consecutive": 2,
                "issueDate": "2026-07-15T13:19:10.000Z",
                "orderCode": "66E-K54",
                "orderUuid": "fe1fab65-3981-4f18-9b4e-12ae11cc0558",
                "recipientName": null,
                "documentTypeName": "Factura POS",
                "isElectronic": 0,
                "transmissionStatus": "pending",
                "taxCents": 1294242,
                "grandTotalCents": 4600000
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 25,
            "total": 1,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        },
        "totals": {
            "count": 1,
            "grandTotalCents": "4600000",
            "taxCents": "1294242",
            "ticketAvgCents": 4600000
        },
        "filters": {
            "documentTypes": [
                {
                    "id": 2,
                    "name": "Factura Electrónica de Venta"
                },
                {
                    "id": 1,
                    "name": "Factura POS"
                },
                {
                    "id": 3,
                    "name": "Nota Crédito Electrónica"
                },
                {
                    "id": 5,
                    "name": "Nota crédito POS"
                }
            ]
        }
    }
}
Volver a Facturación