Contrato OpenAPI 3.1 · V2.0

Intención adentro.
SKU afuera.

NexoCesta se integra como una capa desacoplada sobre el ecommerce. El retailer mantiene catálogo, precios, checkout, pagos y logística.

Abrir OpenAPI JSON Ver endpoints

Límite contractual

NexoCesta termina cuando entrega el carrito al ecommerce.

Catálogo aislado por retailer y sucursalAPI keys hasheadas; secreto visible una sola vezHosted, deep link, REST o custom adapterSin tarjetas, direcciones ni delivery

Integración por capacidad

Tres entradas.
Un mismo contrato.

No asumimos que todos los retailers tienen API en tiempo real. CSV y JSON atraviesan el mismo normalizador; REST usa allowlist y validación estructurada.

01

Hosted

Piloto rápido con experiencia NexoCesta y handoff temporal, sin pagos ni datos personales.

02

Embedded

Launcher browser sin secretos para abrir la experiencia desde el ecommerce existente.

03

Headless

El retailer diseña su UI y consume intención, SKU, cantidades y handoff desde su backend.

AuthBearer key
InputCSV · JSON · API
OutputSKU + quantity
TenancyRetailer + store

Endpoint ledger

Superficie HTTP real

GET/api/v1/healthEstado y versión del WorkerPublic
POST/api/v1/intent/resolveResuelve intención demoPublic
POST/api/v1/intent-to-cartIntent-to-cart del catálogo demoPublic
POST/api/v1/demo/intent-to-cartIntent-to-cart read-only para Retailer Digital TwinPublic
GET/api/v1/integration/capabilitiesDescubre capacidades y manifest del retailer autenticadoAPI key
POST/api/v1/integration/catalog/import/csvImporta CSV al tenant autenticadoAPI key
POST/api/v1/integration/catalog/import/jsonImporta feed JSON canónicoAPI key
GET/api/v1/integration/catalog/productsLista productos del retailer autenticadoAPI key
GET/api/v1/integration/catalog/products/{sku}Obtiene un SKU dentro del tenantAPI key
POST/api/v1/integration/cart/resolveHeadless intent-to-cart para el catálogo del retailerAPI key
POST/api/v1/integration/cart/handoffEntrega SKU y cantidades al modo de carrito configuradoAPI key
POST/api/v1/integration/hosted-carts/{id}Lee un carrito hosted mediante capability token de corta duraciónPublic
GET/api/v1/integration/doctorReadiness: READY, READY_FOR_DEMO o NOT_READYAPI key
POST/api/v1/integration/admin/retailersCrea o actualiza retailer, store y manifestAPI key
POST/api/v1/integration/admin/api-keysCrea API key; el secreto sólo aparece una vezAPI key