Skip to content

Releases

v1.0.0-draft · Primer borrador público del contrato v1

Choose a tag to compare

@SomaVenezuela SomaVenezuela released this 04 Nov 19:08

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-run con 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_id y part_number; extracted_at con 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; uom opcional con conversi�n.
  • Errores application/problem+json con 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/