Recepciones

Ver una recepción

Devuelve una recepción con su orden, proveedor, depósito, remito del proveedor, cotización, líneas con su despacho y lo revertido, y sus reversiones.

GET/api/v1/purchase-orders/get-receipt

Permiso: purchase-orders.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

goodsReceiptIduuidrequerido

Respuesta

200 con este JSON.

iduuidrequerido
numbertextorequerido
statusopciónrequerido
Valores: draft closed discarded
reversalopciónrequerido
Valores: none partial total
receiptDatefecharequerido
purchaseOrderobjetorequerido
Campos (4)
- iduuidrequerido
- numbertextorequerido
- statusopciónrequerido
  Valores: draft issued closed discarded
- currencyCodetextorequerido
supplierobjetorequerido
Campos (4)
- iduuidrequerido
- codeenterorequerido
- legalNametextorequerido
- cuitcualquierarequerido
supplierDeliveryNotecualquierarequerido
warehouseobjetorequerido
Campos (4)
- iduuidrequerido
- codetextorequerido
- nametextorequerido
- statusopciónrequerido
  Valores: active inactive
versionenterorequerido
mínimo 1
exchangeRatecualquierarequerido
notescualquierarequerido
lineslista de objetorequerido
Campos de cada elemento (14)
- iduuidrequerido
- purchaseOrderLineIduuidrequerido
- itemobjetorequerido
  Campos (7)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - statusopciónrequerido
    Valores: active inactive
  - unitCodetextorequerido
  - unitNametextorequerido
  - allowsDecimalssí o norequerido
- isImportedsí o norequerido
- supplierCodecualquierarequerido
- quantitynúmerorequerido
- customsDeclarationcualquierarequerido
- unitCostcualquiera
- revertedQuantitynúmerorequerido
- revertibleQuantitynúmerorequerido
- reversalAtReceiptCostcualquierarequerido
- reversalCostReasonopciónrequeridoadmite null
  Valores: later-entry negative
- invoicedQuantitynúmerorequerido
- invoiceslista de objetorequerido
  Campos de cada elemento (5)
  - iduuidrequerido
  - numbertextorequerido
  - labeltextorequerido
  - totalcualquierarequerido
  - currencyCodetextorequerido
stockMovementobjetorequeridoadmite null
Campos (2)
- iduuidrequerido
- numbertextorequerido
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 (2)
  - goodsReceiptLineIduuidrequerido
  - quantitynúmerorequerido
createdAtfecha y horarequerido
createdByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
closedAtfecha y horarequeridoadmite null
closedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
discardedAtfecha y horarequeridoadmite null
discardedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
discardReasoncualquierarequerido

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

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/purchase-orders/get-receipt?goodsReceiptId=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",
  "number": "texto",
  "status": "draft",
  "reversal": "none",
  "receiptDate": "2026-10-23",
  "purchaseOrder": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "number": "texto",
    "status": "draft",
    "currencyCode": "texto"
  },
  "supplier": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": 1,
    "legalName": "texto",
    "cuit": null
  },
  "supplierDeliveryNote": null,
  "warehouse": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": "texto",
    "name": "texto",
    "status": "active"
  },
  "version": 1,
  "exchangeRate": null,
  "notes": null,
  "lines": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "purchaseOrderLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "item": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "status": "active",
        "unitCode": "texto",
        "unitName": "texto",
        "allowsDecimals": false
      },
      "isImported": false,
      "supplierCode": null,
      "quantity": 100,
      "customsDeclaration": null,
      "unitCost": null,
      "revertedQuantity": 100,
      "revertibleQuantity": 100,
      "reversalAtReceiptCost": null,
      "reversalCostReason": "later-entry",
      "invoicedQuantity": 100,
      "invoices": [
        {
          "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
          "number": "texto",
          "label": "texto",
          "total": null,
          "currencyCode": "texto"
        }
      ]
    }
  ],
  "stockMovement": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "number": "texto"
  },
  "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": [
        {
          "goodsReceiptLineId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
          "quantity": 100
        }
      ]
    }
  ],
  "createdAt": "2026-10-23T14:30:00.000Z",
  "createdBy": {
    "id": "texto",
    "name": null
  },
  "closedAt": "2026-10-23T14:30:00.000Z",
  "closedBy": {
    "id": "texto",
    "name": null
  },
  "discardedAt": "2026-10-23T14:30:00.000Z",
  "discardedBy": {
    "id": "texto",
    "name": null
  },
  "discardReason": null
}