Facturación

Listar el pool de facturación

Lista todo lo pendiente de facturar, de lo más viejo a lo más nuevo: cada remito emitido con algo sin facturar y cada pedido confirmado con líneas nunca remitidas, con su cliente, condiciones congeladas y líneas.

GET/api/v1/documents/list-billable

Permiso: documents.prepare
Empresa: Opera sobre la empresa activa
Tipo: Lectura: no cambia nada
Respuesta: JSON

Encabezados

Cookietextorequerido
La cookie de sesión del usuario de la integración (__Secure-erp.session_token). Cuando esté la clave API, va en Authorization: Bearer. Ver Autenticación.
X-Expected-Companyuuidrequerido
La empresa sobre la que operás. Si no coincide con la de la credencial, responde 409. Ver Empresa activa.

Respuesta

200 con este JSON.

rowslista de objetorequerido
Campos de cada elemento (10)
- kindopciónrequerido
  Valores: delivery-note sales-order
- iduuidrequerido
- numbertextorequerido
- documentDatefecharequerido
- customerobjetorequerido
  Campos (5)
  - iduuidrequerido
  - legalNametextorequerido
  - letteropciónrequerido
    Valores: A B
  - needsCuitsí o norequerido
  - addresstextorequerido
- xsí o norequerido
- paymentTermIduuidrequeridoadmite null
- paymentPlanlista de objetorequerido
  Campos de cada elemento (2)
  - percentnúmerorequerido
  - dueDaysenterorequerido
- xPointOfSaleIduuidrequeridoadmite null
- lineslista de objetorequerido
  Campos de cada elemento (8)
  - salesOrderobjetorequerido
    Campos (2)
    iduuidrequerido
    numbertextorequerido
  - salesOrderLineIduuidrequerido
  - deliveryNoteLineIduuidrequeridoadmite null
  - itemobjetorequerido
    Campos (7)
    iduuidrequerido
    codetextorequerido
    nametextorequerido
    unitCodetextorequerido
    allowsDecimalssí o norequerido
    itemTypetextorequerido
    vatRatecualquierarequerido
  - pendingQuantitynúmerorequerido
  - unitPricetextorequerido
  - discountPercentnúmerorequerido
  - headerDiscountPercentnúmerorequerido
pointsOfSalelista de objetorequerido
Campos de cada elemento (4)
- iduuidrequerido
- numberenterorequerido
- descriptiontextorequerido
- isDefaultsí o norequerido
issuerProblemslista de textorequerido
todayfecharequerido

Errores

Un rechazo responde application/problem+json con un code estable. Los más comunes en esta operación:

`401`	Falta la credencial o venció.
`403`	La credencial no tiene el permiso `documents.prepare`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`422`	Datos inválidos o una regla de negocio rota, con el detalle por campo.
`503`	Sistema ocupado: reintentá después de `Retry-After` segundos.

La lista completa está en Errores.

curl
TypeScript

curl "$ERP_URL/api/v1/documents/list-billable" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/documents/list-billable`, {
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "rows": [
    {
      "kind": "delivery-note",
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "number": "texto",
      "documentDate": "2026-10-23",
      "customer": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "legalName": "texto",
        "letter": "A",
        "needsCuit": false,
        "address": "texto"
      },
      "x": false,
      "paymentTermId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "paymentPlan": [
        {
          "percent": 100,
          "dueDays": 1
        }
      ],
      "xPointOfSaleId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "lines": [
        {
          "salesOrder": {
            "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
            "number": "texto"
          },
          "salesOrderLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
          "deliveryNoteLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
          "item": {
            "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
            "code": "texto",
            "name": "texto",
            "unitCode": "texto",
            "allowsDecimals": false,
            "itemType": "texto",
            "vatRate": null
          },
          "pendingQuantity": 100,
          "unitPrice": "texto",
          "discountPercent": 100,
          "headerDiscountPercent": 100
        }
      ]
    }
  ],
  "pointsOfSale": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "number": 1,
      "description": "texto",
      "isDefault": false
    }
  ],
  "issuerProblems": [
    "texto"
  ],
  "today": "2026-10-23"
}