Skip to main content

Desarrolladores · Esquemas

Esquemas y el mapa de campos de la CN 23

Un JSON Schema para artículos postales. Sigue la declaración de aduana CN 22 y CN 23, que el mensaje ITMATT de la UPU transmite en forma electrónica.

Descargas

JSON Schema, borrador 2020-12. Use el valor SHA-256 para verificar su copia.

JSON Schema 2020-12

postal-items.v1.json

Lote, despacho, artículo y contenido.

SHA-256:
ddfdad6b61137e8e68298b39716200a95c2a577914c9bae8bca4b74b59d87884
Tamaño:
8,237 B
Descargar

Ejemplo

postal-items.v1.example.json

Un despacho con un artículo. Es válido según el esquema.

SHA-256:
02cf9af6f851f2b89d658b9fe4cf82bdd2270f1739ef89b3e9b081ed783bec4a
Tamaño:
1,179 B
Descargar

OpenAPI 3.1Previsto

postal-api.v1.yaml

La descripción de la API, que se publica con el entorno de pruebas.

Contenido de la CN 23, campo de Allied y registro de ACE

Los artículos postales no llevan guía aérea máster ni guía aérea hija. El identificador de artículo S10 cumple esa función (Directrices WCO-UPU sobre el intercambio de datos electrónicos anticipados, 2025).
Contenido de la CN 23, campo de Allied y registro de ACE
Contenido de la CN 22 / CN 23Campo de AlliedACE, entrada tipo 13
Identificador de artículo S10item_idConocimiento de embarque en SE15 (aéreo: SFP + S10, emisor en blanco; camión, ferrocarril, marítimo: emisor SFP); registro 23 de AE, tipo M
RemitentesenderNombre en SE30 y dirección en SE35 (obligatorios)
DestinatarioaddresseeConsignatario en SE30, por nombre y dirección; parte «Final Delivered To»
Categoría del artículonature_code (lista de códigos 136 de la UPU)Dato para la revisión de riesgos
Cantidad y descripción detalladacontents[].description, quantityDescripción comercial en SE40 (obligatoria)
Peso netocontents[].net_weight_kgCantidad y peso cuando se aplica una tasa arancelaria específica
Valorcontents[].value, currencyValor de la línea en SE60 (obligatorio); límite de $2,500 (código 323)
Número arancelario HScontents[].hs_codeNúmero HTSUS de 10 dígitos y números del Chapter 99 (SE60), asignados por Allied
País de origencontents[].origin_countryPaís de origen

Campos del artículo

Los campos de un artículo.
Campos del artículo
CampoTipoObligatorioRegla
item_idstringSíUPU S10: 2 letras, 8 dígitos, dígito de control, 2 letras.
nature_codeintegerSíLista de códigos 136 de la UPU.
senderobjectSíNombre y dirección (línea 1, ciudad, país).
addresseeobjectSíNombre y dirección en EE. UU. con un código ZIP de 5 dígitos.
contents[]arraySíDe 1 a 99 líneas.
contents[].descriptionstringSíDe 3 a 200 caracteres, lo bastante precisa para clasificar.
contents[].quantityintegerSí1 o más.
contents[].net_weight_kgnumberSíMayor que 0.
contents[].valuestringSíDecimal con 2 posiciones decimales, por ejemplo 45.00.
contents[].hs_codestringSíDe 6 a 10 dígitos.
contents[].origin_countrystringSíCódigo de país ISO 3166-1 alpha-2.
currencystringSíCódigo de moneda ISO 4217.
gross_weight_kgnumberSíMayor que 0.
postage_paid, insurancestringNoDecimal con 2 posiciones decimales.
receptacle_idstringNoIdentificador UPU S9 de la saca que contiene el artículo.

Códigos de naturaleza del artículo

Lista de códigos 136 de la UPU.
Códigos de naturaleza del artículo
CódigoSignificado
11Venta de mercancías
111Venta comercial de mercancías (entre empresas)
21Mercancías devueltas
31Regalo
32Muestra comercial
91Documentos
999Otro

Lote de ejemplo

El archivo postal-items.v1.example.json.
postal-items.v1.example.json
{  "batch_ref": "POST-DISPATCH-2026-10-01-A",  "sent_at": "2026-10-01T09:30:00Z",  "dispatch": {    "dispatch_id": "DISPATCH-0001",    "mode": "AIR",    "carrier": "EXAMPLE AIRLINE",    "flight_or_trip": "XX123",    "us_port_code": "4701",    "expected_arrival_date": "2026-10-02"  },  "items": [    {      "item_id": "CP123456785CA",      "nature_code": 11,      "sender": {        "name": "EXAMPLE SHOP LTD",        "address": {          "line1": "100 EXAMPLE ST",          "city": "TORONTO",          "region": "ON",          "postal_code": "M5V1A1",          "country": "CA"        }      },      "addressee": {        "name": "JANE SAMPLE",        "address": {          "line1": "100 MAIN ST",          "city": "NEWARK",          "state": "NJ",          "zip5": "07102"        }      },      "contents": [        {          "description": "WOMEN'S KNITTED COTTON SWEATER",          "quantity": 1,          "net_weight_kg": 0.4,          "value": "45.00",          "hs_code": "611020",          "origin_country": "CA"        }      ],      "currency": "CAD",      "gross_weight_kg": 0.5,      "postage_paid": "18.50"    }  ]}

Empiece con una prueba de datos

Envíenos un despacho postal de muestra en JSON, CSV o Excel. Le informamos de cada carencia en los datos antes de la primera declaración. Cotización a solicitud.

Llame al (908) 291-8001 o escriba a mail@alliedchb.com

Escriba al equipo postalResumen de la entrada tipo 13

Esta página es una traducción. La versión en inglés de este sitio web es la versión oficial. Nuestros formularios en línea y nuestros documentos están en inglés. English