Crear recepción de mercancía

{
  "external_store_id": "tienda-principal",
  "external_supplier_id": "proveedor-fresco",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "FAC-2026-001",
  "lines": [
    {
      "external_item_id": "tomate-bola",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 25.00
    }
  ],
  "external_user_id": "almacenista_01"
}

{
  "id": "gr_01...",
  "status": "COMPLETED",
  "store_id": "str_principal_01...",
  "supplier_id": "sup_01...",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "FAC-2026-001",
  "lines": [
    {
      "id": "grl_01...",
      "item_id": "itm_01...",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 25.00
    }
  ]
}

{
  "error": {
    "kind": "store_not_found",
    "message": "Store not found"
  }
}

POST

api

public

vendors

{vendorId}

operations

goods-receipts

{
  "external_store_id": "tienda-principal",
  "external_supplier_id": "proveedor-fresco",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "FAC-2026-001",
  "lines": [
    {
      "external_item_id": "tomate-bola",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 25.00
    }
  ],
  "external_user_id": "almacenista_01"
}

{
  "id": "gr_01...",
  "status": "COMPLETED",
  "store_id": "str_principal_01...",
  "supplier_id": "sup_01...",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "FAC-2026-001",
  "lines": [
    {
      "id": "grl_01...",
      "item_id": "itm_01...",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 25.00
    }
  ]
}

{
  "error": {
    "kind": "store_not_found",
    "message": "Store not found"
  }
}

string

requerido

API key de BOH con scope inventory:write.

string

requerido

UUID del vendor.

string

UUID del establecimiento de destino. Se requiere store_id o external_store_id.

string

ID externo del establecimiento.

string

UUID del proveedor. Se requiere supplier_id o external_supplier_id.

string

ID externo del proveedor.

string

Cuándo ocurrió la recepción (ISO 8601). Por defecto: ahora.

string

Número de referencia o albarán.

string

Notas de texto libre.

object[]

requerido

Líneas de artículos recibidos.

Mostrar campos de línea

string

UUID del artículo.

string

ID externo del artículo.

number

requerido

Cantidad recibida.

string

requerido

UUID de la unidad.

number

Costo unitario (para valoración).

string

Notas de línea.

string

requerido

Actor que realiza la recepción.

string

Clave de idempotencia para prevenir duplicados.

{
  "external_store_id": "tienda-principal",
  "external_supplier_id": "proveedor-fresco",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "FAC-2026-001",
  "lines": [
    {
      "external_item_id": "tomate-bola",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 25.00
    }
  ],
  "external_user_id": "almacenista_01"
}

{
  "id": "gr_01...",
  "status": "COMPLETED",
  "store_id": "str_principal_01...",
  "supplier_id": "sup_01...",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "FAC-2026-001",
  "lines": [
    {
      "id": "grl_01...",
      "item_id": "itm_01...",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 25.00
    }
  ]
}

{
  "error": {
    "kind": "store_not_found",
    "message": "Store not found"
  }
}

Descripción general

Identidad

Establecimientos

Proveedores

Artículos de catálogo

Sincronización de catálogo

Recetas

Recepciones de mercancía

Conteos de inventario

Eventos de merma

Transferencias

Lotes de producción

Seguimiento

Niveles de reorden

Pedido sugerido

Órdenes de compra

Líneas de OC

Webhooks

Crear recepción de mercancía