Dinet EcommerceEMSD
EMSD
API REST · v1.0

Ecommerce Management System Dinet

Documentación técnica de la API REST de EMSD, la plataforma logística de Dinet para el comercio electrónico. Cubre los módulos de integración disponibles: registro de pedidos, compatibilidad D4W y seguimiento de envíos.

Comenzar integraciónMódulos disponibles

Integración

Inicio rápido

La primera petición a la API requiere tres pasos: obtención de credenciales, selección del módulo apropiado y envío de la solicitud al ambiente correspondiente.

  1. 1

    Obtención de credenciales

    Solicitar al equipo de integración Dinet los headers X-Client-Id y X-Integration-Auth, los cuales identifican la cuenta del cliente y autorizan las llamadas a la API.

  2. 2

    Selección del módulo

    Utilizar el módulo Pedidos en formato nativo EMSD para integraciones nuevas, o el módulo Integración OLD en formato D4W para migraciones desde sistemas heredados.

  3. 3

    Envío de la solicitud

    Realizar la petición HTTP al ambiente QA durante la fase de desarrollo y al ambiente PROD una vez validada la integración. La respuesta incluye el número de documento interno, el número de tracking y la URL de consulta del estado.

POST /ordersbash
curl -X POST https://emsd-qa.dinet.com.pe/backoffice/integration/api/v1/orders \
  -H "X-Client-Id: $DINET_CLIENT_ID" \
  -H "X-Integration-Auth: $DINET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "order_number": "ORD-2024-001",
    "modality_code": "STD",
    "recipient": { "name": "Jane Smith", "document": "87654321" },
    "origin":      { "point_code": "WH-LIMA-01" },
    "destination": { "address": "Av. Lima 123", "ubigeo": "150101" }
  }'

Estructura

Módulos de la API

La API se organiza por módulos según el dominio de integración. Cada módulo agrupa los endpoints relacionados con su contrato técnico, ejemplos de payload y especificación de respuestas.

Información

Referencia técnica

Autenticación

Cada petición requiere los dos headers de identificación. La ausencia de cualquiera produce una respuesta HTTP 401 — Unauthorized.

X-Client-Id
Identificador del cliente integrado
X-Integration-Auth
Token de autorización de integración

Ambientes

La API se encuentra disponible en dos ambientes. Las solicitudes deben dirigirse al endpoint correspondiente según la fase de la integración.