List Financial Documents

GET

/api/financial-docs

Returns a paginated list of financial documents for the authenticated tenant,
sorted by lastUpdate in descending order.

Each document represents a billing record that may include:

An invoice (Factura CFDI)

One or more payments (Complementos de Pago or Notas de Crédito)

Cancellation records if applicable

Use limit to control page size and lastUpdate to paginate by date (load more older records).

Joining with Shipments

Use FinancialDocument.id to match against TripDocument.idFinan to retrieve
the associated shipment details for any financial document.

Status Reference

Value	Label	Description
1	Cargado	Loaded — shipment in transit
2	Descargado	Unloaded — delivery completed
3	Por Facturar	Pending invoice generation
4	Facturado	Invoice issued
5	Pago Parcial	Partially paid
6	Pagado	Fully paid
7	Incidente	Incident reported
9	Cancelado	Cancelled

Solicitud

Autorización

API Key

Agregar parámetro en header

x-api-key

Ejemplo:

x-api-key: ********************

Parámetros de consulta

Respuestas

🟢200

application/json

Successful response with financial document list

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠429TooManyRequests

🔴500InternalServerError

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://api.dufrei.com/api/financial-docs?limit=undefined&lastUpdate=undefined' \
--header 'x-api-key: <api-key>'

Ejemplo de Respuesta

200 - Fully paid document with credit note and payment complement

[
    {
        "_id": "695ed6cee303ca588a8f97f1",
        "id": "1765368000000_0866e",
        "company": "TEK170407IA0",
        "client": "PME380607P35",
        "date": 1765346400,
        "timestamp": 1765368000,
        "iSub": 71328.36,
        "iTax1": 11412.54,
        "iTax2": 2317.48,
        "iTot": 80423.42,
        "ref1": "2025-90237",
        "ref2": "T-246",
        "status": 6,
        "statusAuth": true,
        "iDesc": 0,
        "iFalt": 0,
        "tarif1": 0.6282,
        "lastUpdate": "2025-06-15T10:30:00.000Z",
        "canceled": [],
        "invoice": {
            "id": "295A6B4A-25E5-56C0-95BF-CCCC0D169E4B",
            "num": "202500384",
            "date": 1765346400,
            "iSub": 71850.84,
            "iTax1": 11496.13,
            "iTax2": 2338.38,
            "iTot": 81008.59,
            "ship": 100550.87,
            "source": 0,
            "toll": 13391.34,
            "files": {
                "pdf": "https://storage.googleapis.com/dufrei-admin/TEK170407IA0/invoice/FC - 295A6B4A-25E5-56C0-95BF-CCCC0D169E4B.pdf",
                "xml": "https://storage.googleapis.com/dufrei-admin/TEK170407IA0/invoice/FC - 295A6B4A-25E5-56C0-95BF-CCCC0D169E4B.xml"
            }
        },
        "payment": [
            {
                "id": "7D6219C7-8F5E-5D8B-8B23-480B8A33DECE",
                "num": "202500314",
                "typePay": "NC",
                "date": 1765908000,
                "iPay": 6751.11,
                "iPend": 74257.48,
                "iPrev": 81008.59,
                "Tax1": 934.07,
                "Tax2": 20.89,
                "files": {
                    "pdf": "https://storage.googleapis.com/dufrei-admin/TEK170407IA0/payment/NC - 7D6219C7-8F5E-5D8B-8B23-480B8A33DECE.pdf",
                    "xml": "https://storage.googleapis.com/dufrei-admin/TEK170407IA0/payment/NC - 7D6219C7-8F5E-5D8B-8B23-480B8A33DECE.xml"
                }
            },
            {
                "id": "D34A55B5-0FC1-52EA-BD86-2E04148AD0AF",
                "num": 202600004,
                "typePay": "03",
                "date": 1768500000,
                "iPay": 74257.48,
                "iPend": 0,
                "iPrev": 74257.48,
                "files": {
                    "pdf": "https://storage.googleapis.com/dufrei-admin/TEK170407IA0/payment/CP - D34A55B5-0FC1-52EA-BD86-2E04148AD0AF.pdf",
                    "xml": "https://storage.googleapis.com/dufrei-admin/TEK170407IA0/payment/CP - D34A55B5-0FC1-52EA-BD86-2E04148AD0AF.xml"
                }
            }
        ]
    }
]

Modificado en 2026-02-24 05:17:23

Initialize SSE Stream

List Shipments

List Financial Documents

Joining with Shipments#

Status Reference#

Solicitud

Respuestas

Joining with Shipments

Status Reference