Repository navigation
Releases
Releases · SomaEngine/soma-api-docs
v1.0.0-draft · Primer borrador público del contrato v1
Primer borrador p�blico del contrato v1. Puede recibir ajustes hasta 1.0.0.
Disponible en el ambiente de pruebas (ventas)
- Clave de API por empresa y ambiente (
soma_test_�/soma_live_�), con alcances por entidad. GET /v1/meta: ubicaciones, conversiones de unidad, unidad de per�odo y base del valor.- Lote en partes: abrir (
POST /v1/ingest/batches), enviar partes (�/parts), probar sin aplicar
(�/dry-run), consultar (GET /v1/ingest/batches/{id}) e historial (GET /v1/ingest/batches). dry-runcon la diferencia contra lo que SOMA tiene (nuevas, modificadas, borradas, sin
cambio), todos los problemas encontrados y los c�digos sin ficha.
Publicado en el contrato, todav�a no disponible
- Confirmar el lote (
�/commit) y el atajo de una llamada (POST /v1/ingest/{entidad}). GET /v1/data-health.- Lotes de inventario, �rdenes de compra y �rdenes de producci�n.
Reglas del contrato
- Dentro del alcance declarado, lo que no viene cuenta como cero.
- Idempotencia por
batch_idypart_number;extracted_atcon zona horaria; conteos
declarados (expected_lines,partition_counts). - Valores en USD y sin IVA. Bruto o neto lo fija la empresa una vez.
- Unidad base por SKU;
uomopcional con conversi�n. - Errores
application/problem+jsoncon c�digos estables. Retenci�n del primer lote sobre datos
cargados por archivo (first_batch_review) y de lotes con ubicaciones desconocidas
(unknown_location).
Documentaci�n: https://somaengine.github.io/soma-api-docs/