{
"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"
}
}
Recepciones de mercancía
Crear recepción de mercancía
Registra una recepción de mercancía de un proveedor. Incrementa los niveles de stock en el almacén de destino.
POST
/
api
/
v1
/
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
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"
}
}