Entregas

Ver un remito

Devuelve un remito con su cliente, destino, depósito, líneas con lo revertido y facturado, sus reversiones y las facturas que lo toman.

GET/api/v1/deliveries/get

Permiso: deliveries.view
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.

Parámetros de la consulta

deliveryIduuidrequerido

Respuesta

200 con este JSON.

iduuidrequerido
deliveryNoteIduuidrequerido
numbertextorequerido
internalNumberenterorequerido
legalNumberenterorequeridoadmite null
statusopciónrequerido
Valores: draft issued discarded
deliveryStatusopciónrequerido
Valores: open closed annulled
reversalopciónrequerido
Valores: none partial total
documentDatefecharequerido
customerobjetorequerido
Campos (4)
- iduuidrequerido
- codeenterorequerido
- legalNametextorequerido
- taxIdtextorequerido
deliveryMethodopciónrequerido
Valores: transport own-fleet customer-pickup
destinationobjetorequerido
Campos (7)
- kindopciónrequerido
  Valores: recipient fiscal-address pickup
- recipientIduuidrequeridoadmite null
- nametextorequerido
- addresstextorequerido
- citytextorequerido
- receiverNamecualquierarequerido
- carrierTaxIdcualquierarequerido
warehouseobjetorequerido
Campos (3)
- iduuidrequerido
- codetextorequerido
- nametextorequerido
pendingInvoicesí o norequerido
cotStatusopciónrequerido
Valores: not-required pending granted rejected
circuitopciónrequerido
Valores: fiscal x
versionenterorequerido
mínimo 1
pointOfSaleobjetorequerido
Campos (3)
- iduuidrequerido
- numberenterorequerido
- descriptiontextorequerido
caicualquierarequerido
caiExpiryfecharequeridoadmite null
notescualquierarequerido
lineslista de objetorequerido
Campos de cada elemento (9)
- iduuidrequerido
- salesOrderobjetorequerido
  Campos (2)
  - iduuidrequerido
  - numbertextorequerido
- salesOrderLineIduuidrequerido
- itemobjetorequerido
  Campos (5)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - unitCodetextorequerido
  - allowsDecimalssí o norequerido
- descriptiontextorequerido
- quantitynúmerorequerido
- revertedQuantitynúmerorequerido
- invoicedQuantitynúmerorequerido
- pendingInvoiceQuantitynúmerorequerido
reversalslista de objetorequerido
Campos de cada elemento (7)
- iduuidrequerido
- reasontextorequerido
- reversalDatefecharequerido
- createdByobjetorequeridoadmite null
  Campos (2)
  - idtextorequerido
  - namecualquierarequerido
- createdAtfecha y horarequerido
- stockMovementobjetorequeridoadmite null
  Campos (2)
  - iduuidrequerido
  - numbertextorequerido
- lineslista de objetorequerido
  Campos de cada elemento (3)
  - deliveryNoteLineIduuidrequerido
  - itemobjetorequerido
    Campos (5)
    iduuidrequerido
    codetextorequerido
    nametextorequerido
    unitCodetextorequerido
    allowsDecimalssí o norequerido
  - quantitynúmerorequerido
invoiceslista de objetorequerido
Campos de cada elemento (3)
- iduuidrequerido
- numbertextorequerido
- statustextorequerido
stockMovementobjetorequeridoadmite null
Campos (2)
- iduuidrequerido
- numbertextorequerido
createdAtfecha y horarequerido
createdByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
issuedAtfecha y horarequeridoadmite null
issuedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
discardedAtfecha y horarequeridoadmite null
discardedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
discardReasoncualquierarequerido
cotobjetorequeridoadmite null
Campos (6)
- statusopciónrequerido
  Valores: not-required pending granted rejected
- numbercualquierarequerido
- sourceopciónrequeridoadmite null
  Valores: arba manual
- messagecualquierarequerido
- inProgresssí o norequerido
- submissionslista de objetorequerido
  Campos de cada elemento (5)
  - attemptenterorequerido
    mínimo 1
  - resultopciónrequerido
    Valores: granted rejected unavailable
  - cotNumbercualquierarequerido
  - messagecualquierarequerido
  - createdAtfecha y horarequerido

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 `deliveries.view`.
`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/deliveries/get?deliveryId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/deliveries/get?deliveryId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90`, {
  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();

{
  "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "deliveryNoteId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "number": "texto",
  "internalNumber": 1,
  "legalNumber": 1,
  "status": "draft",
  "deliveryStatus": "open",
  "reversal": "none",
  "documentDate": "2026-10-23",
  "customer": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": 1,
    "legalName": "texto",
    "taxId": "texto"
  },
  "deliveryMethod": "transport",
  "destination": {
    "kind": "recipient",
    "recipientId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "name": "texto",
    "address": "texto",
    "city": "texto",
    "receiverName": null,
    "carrierTaxId": null
  },
  "warehouse": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": "texto",
    "name": "texto"
  },
  "pendingInvoice": false,
  "cotStatus": "not-required",
  "circuit": "fiscal",
  "version": 1,
  "pointOfSale": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "number": 1,
    "description": "texto"
  },
  "cai": null,
  "caiExpiry": "2026-10-23",
  "notes": null,
  "lines": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "salesOrder": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "number": "texto"
      },
      "salesOrderLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "item": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "unitCode": "texto",
        "allowsDecimals": false
      },
      "description": "texto",
      "quantity": 100,
      "revertedQuantity": 100,
      "invoicedQuantity": 100,
      "pendingInvoiceQuantity": 100
    }
  ],
  "reversals": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "reason": "texto",
      "reversalDate": "2026-10-23",
      "createdBy": {
        "id": "texto",
        "name": null
      },
      "createdAt": "2026-10-23T14:30:00.000Z",
      "stockMovement": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "number": "texto"
      },
      "lines": [
        {
          "deliveryNoteLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
          "item": {
            "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
            "code": "texto",
            "name": "texto",
            "unitCode": "texto",
            "allowsDecimals": false
          },
          "quantity": 100
        }
      ]
    }
  ],
  "invoices": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "number": "texto",
      "status": "texto"
    }
  ],
  "stockMovement": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "number": "texto"
  },
  "createdAt": "2026-10-23T14:30:00.000Z",
  "createdBy": {
    "id": "texto",
    "name": null
  },
  "issuedAt": "2026-10-23T14:30:00.000Z",
  "issuedBy": {
    "id": "texto",
    "name": null
  },
  "discardedAt": "2026-10-23T14:30:00.000Z",
  "discardedBy": {
    "id": "texto",
    "name": null
  },
  "discardReason": null,
  "cot": {
    "status": "not-required",
    "number": null,
    "source": "arba",
    "message": null,
    "inProgress": false,
    "submissions": [
      {
        "attempt": 1,
        "result": "granted",
        "cotNumber": null,
        "message": null,
        "createdAt": "2026-10-23T14:30:00.000Z"
      }
    ]
  }
}