addresses

Crear (o reutilizar) un remitente

Create-or-reuse con el MISMO dedupe exacto normalizado que usa POST /shipments al registrar direcciones inline, evaluado sobre las filas visibles para la llave: si ya existe un remitente idéntico visible, se devuelve ese (created: false, 200); si no, se crea (created: true, 201). El postal_code debe tener 5 dígitos y EXISTIR en el catálogo postal (SEPOMEX); si city/state vienen, deben ser coherentes con el CP (un desajuste responde 422 nombrando el valor esperado) y si se omiten se AUTOCOMPLETAN del catálogo — la misma validación de exactitud que POST /contacts/import. Requiere scope addresses:write. Con X-PDV-ID (llave admin), la fila creada pertenece al directorio de ese PDV y queda visible para su personal.

post/senders

Request

  • Base URL: https://api.enviadores.com.mx/api/v1
  • URL: https://api.enviadores.com.mx/api/v1/senders
  • Auth: HTTP bearer

Headers

X-PDV-IDstring

Solo llaves de cuentas admin: el punto de venta cuyo fondo se carga/consulta. Requiere que la llave tenga una allowlist de PDVs configurada por un administrador (pdv_allowlist); sin allowlist, todo PDV real es denegado por defecto. Validado además contra los PDV activos. Cualquier violación → 403 PDV_NOT_ALLOWED. El valor personal_account equivale a omitir el header.

Request body

namestring required

Nombre de pila (nombre).

apellido_paternostring

DEPRECATED (2026-09-21): el nombre completo va en name. Aún se acepta y se integra a name al guardar.

apellido_maternostring

DEPRECATED (2026-09-21): el nombre completo va en name. Aún se acepta y se integra a name al guardar.

companystring

Razón social.

rfcstring
phonestring required
emailstring email
streetstring required
numberstring

Número exterior.

coloniastring required
citystring

Opcional: si se omite se autocompleta del catálogo SEPOMEX según el CP; si viene, debe coincidir con el CP (si no → 422 nombrando la ciudad esperada).

statestring

Opcional: si se omite se autocompleta del catálogo SEPOMEX según el CP; si viene, debe coincidir con el CP (si no → 422 nombrando el estado esperado).

postal_codestring required

5 dígitos; debe EXISTIR en el catálogo postal (SEPOMEX).

country'MX'

Opcional. Solo MX — cualquier otro valor responde 422.

Example request

{
  "name": "Juan Pérez García",
  "phone": "5512345678",
  "email": "juan@ejemplo.com",
  "street": "Av. Insurgentes Sur",
  "number": "600",
  "colonia": "Del Valle",
  "city": "Ciudad de México",
  "state": "CDMX",
  "postal_code": "01000"
}

Response

Remitente idéntico ya existente reutilizado (created: false).

successunknown required
requestIdstring required

Correlación de logs; también en el header X-Request-Id.

Changes

No recorded changes to this operation across all 1 revision of this API.