Referencia API

Endpoints de las seis apps. Base URL https://api.bodegito.com/v1 — Beta: los endpoints siguen la instantánea OpenAPI.

Beta — esta referencia puede ir por detrás de la instantánea OpenAPI (/api/openapi.json); en caso de conflicto, manda la instantánea.

Convenciones

  • Paginación: ?page=&page_size= (20 por defecto, máx. 200). Filtros: ?filter[field]=value. Orden: ?sort=-created_at.
  • Sobre: cada lista devuelve {data, page, page_size, total}. Cada escritura devuelve el recurso creado/actualizado.
  • Idempotencia: los POST aceptan la cabecera Idempotency-Key; reintente webhooks y pedidos con seguridad.

WMS

GET/wms/inventoryConsultar inventariofilter[sku], filter[warehouse_id]
POST/wms/inventory/adjustAjustar inventariosku, warehouse_id, qty_delta, reason
GET/wms/receiptsListar recepciones
POST/wms/receiptsCrear recepciónmerchant_id, warehouse_id, lines[]
POST/wms/receipts/{id}/receiveRecibir líneaslines[{sku, qty_received, pallet_id}]
GET/wms/shipmentsListar envíos
POST/wms/shipmentsCrear envíomerchant_id, warehouse_id, lines[]
POST/wms/shipments/{id}/shipEnviar
POST/wms/shipments/{id}/deliverConfirmar entregadelivered_at, signed_by
GET/wms/wavesListar olas
POST/wms/waves/releaseLiberar olawave_id
GET/wms/loadsListar cargas
POST/wms/loads/{id}/shipEnviar carga

OMS

GET/oms/ordersListar pedidosfilter[status], filter[merchant_id]
POST/oms/ordersCrear pedidomerchant_id, channel, lines[]
POST/oms/orders/{id}/releaseLiberar pedido a WMS
GET/oms/inventoryConsultar inventario OMS
POST/oms/inventory/adjustAjustar inventario OMS
GET/oms/channels/connectionsListar conexiones
POST/oms/channels/connectionsCrear conexiónchannel, credentials, sync_scopes[]
POST/oms/channels/connections/{id}/testProbar conexión
GET/oms/product-mappingsListar mapeos
POST/oms/product-mappingsCrear mapeoconnection_id, channel_sku, oms_product_id
POST/oms/sync/inventorySincronizar inventarioconnection_id
POST/oms/sync/productsPublicar productosconnection_id, product_ids[]

Compras

GET/purchase/ordersListar órdenes de comprafilter[status], filter[merchant_id]
POST/purchase/ordersCrear orden de compravendor_id, merchant_id, lines[]
POST/purchase/orders/{id}/releaseLiberar a WMS
GET/purchase/asnsListar ASN
POST/purchase/asnsCrear ASNpo_id, merchant_id, eta
GET/purchase/vendorsListar proveedores
POST/purchase/vendorsCrear proveedorname, contact

YMS

GET/yms/appointmentsListar citasfilter[date], filter[type]
POST/yms/appointmentsCrear citacarrier, plate, container_no, window_start, window_end
POST/yms/appointments/{id}/check-inRegistrar llegada
POST/yms/gate-entriesRegistrar puertaplate, direction, appointment_id
GET/yms/movementsListar movimientos
POST/yms/movementsCrear movimientotrailer_id, to_location
POST/yms/movements/{id}/completeCompletar movimiento
GET/yms/yard-mapMapa del patio

TMS

GET/tms/ordersListar órdenes de transporte
POST/tms/ordersCrear orden de transporteload_id, origin, destination
POST/tms/orders/{id}/assignAsignar transportistacarrier_id, rate
GET/tms/orders/{id}/trackingRastrear
POST/tms/orders/{id}/podSubir PODpod_files[]
GET/tms/carriersListar transportistas
GET/tms/freight-billsFacturas de flete

Drayage

GET/drayage/ordersListar órdenesfilter[merchant_id]
POST/drayage/ordersCrear ordenmerchant_id, container_no, pickup, delivery
POST/drayage/orders/{id}/completeCompletar
GET/drayage/containersRastrear contenedores
GET/drayage/containers/{no}/eventsEventos del contenedor

Crear un pedido

Request
POST /v1/oms/orders
{
  "merchant_id": "mch_acme",
  "channel": "shopify",
  "lines": [{ "sku": "ACME-WIDGET-01", "qty": 10 }]
}
Response
201 Created
{ "id": "so_9f31", "status": "draft",
  "merchant_id": "mch_acme", "lines": [...] }