Crossdocker API

Con esta API usted da de alta en Crossdocker los paquetes y los manifiestos que llegan a la bodega.

Crossdocker recibe la carga en la bodega, la cuadra con sus manifiestos y entrega cada paquete a su transportista de última milla. Cuando ese transportista tiene integración, Crossdocker le envía el paquete en el mismo momento y le devuelve a usted su respuesta.

Todas las peticiones y respuestas son JSON, con la codificación de caracteres UTF-8 (la que admite tildes, ñ y cualquier alfabeto). Toda petición lleva un token en Authorization: Bearer.

Use this API to register in Crossdocker the packages and manifests that arrive at the warehouse.

Crossdocker receives the cargo at the warehouse, reconciles it against its manifests and hands each package over to its last-mile carrier. When that carrier is integrated, Crossdocker forwards the package to it immediately and returns the carrier's response to you.

All requests and responses are JSON, with UTF-8 character encoding (which supports accents and any alphabet). Every request carries a token in Authorization: Bearer.

通过此 API，您可以在 Crossdocker 中登记到达仓库的包裹和舱单。

Crossdocker 在仓库接收货物，将其与舱单核对，并把每个包裹交给对应的末端配送承运商。如果该承运商已完成对接，Crossdocker 会立即把包裹转发给它，并把承运商的响应原样返回给您。

所有请求和响应均为 JSON，字符编码为 UTF-8（支持重音字母和任何文字，包括中文）。每个请求都需要在 Authorization: Bearer 中携带令牌。

Pida un token con su usuario y su contraseña (OAuth 2.0, grant_type=password). El cuerpo va como application/x-www-form-urlencoded.

El token dura 8 horas (expires_in, en segundos). Reutilícelo hasta que caduque: no pida uno por petición.

Sin token, o con uno caducado o de otro sistema, la API responde 401 con el cuerpo vacío.

Request a token with your username and password (OAuth 2.0, grant_type=password). The body is application/x-www-form-urlencoded.

The token lasts 8 hours (expires_in, in seconds). Reuse it until it expires: do not request one per call.

With no token, or an expired one, or one from another system, the API returns 401 with an empty body.

使用您的用户名和密码申请令牌（OAuth 2.0，grant_type=password）。请求体格式为 application/x-www-form-urlencoded。

令牌有效期为 8 小时（expires_in，单位为秒）。请在过期前重复使用，不要每次请求都申请新令牌。

如果没有令牌、令牌已过期或来自其他系统，API 返回 401，响应体为空。

Da de alta un paquete. Se envía uno por petición y lo identifica order.id_order, que es su tracking.

• Si last_mile_partner es un transportista con integración (por ejemplo MOOVIN), Crossdocker se lo envía en ese momento y le devuelve a usted la respuesta del transportista.
• Si es otro transportista, el paquete se queda en Crossdocker y la respuesta tiene la misma forma, con un idPackage de Crossdocker.
• Si falta last_mile_partner o no se reconoce, el paquete se acepta igual (200) y queda retenido en la bodega hasta que se aclare su transportista.

No distingue mayúsculas en last_mile_partner. Acepta los nombres en snake_case y en camelCase (id_order o idOrder), el peso como texto o como número, e ignora los campos que no conoce. El cuerpo completo se guarda y se reenvía al transportista sin cambios.

Registers one package per request, identified by order.id_order, its tracking number.

• If last_mile_partner is an integrated carrier (for example MOOVIN), Crossdocker forwards the package to it immediately and returns the carrier's response to you.
• For any other carrier, the package stays in Crossdocker and the response has the same shape, with a Crossdocker idPackage.
• If last_mile_partner is missing or unknown, the package is still accepted (200) and held at the warehouse until its carrier is clarified.

last_mile_partner is case-insensitive. Field names are accepted in snake_case and camelCase (id_order or idOrder), the weight as a string or a number, and unknown fields are ignored. The full body is stored and forwarded to the carrier unchanged.

每次请求登记一个包裹，以 order.id_order（即运单号）作为标识。

• 如果 last_mile_partner 是已对接的承运商（例如 MOOVIN），Crossdocker 会立即转发，并把承运商的响应返回给您。
• 如果是其他承运商，包裹留在 Crossdocker，响应格式相同，idPackage 由 Crossdocker 分配。
• 如果缺少 last_mile_partner 或无法识别，包裹仍会被接受（200），并暂扣在仓库，直到确认承运商。

last_mile_partner 不区分大小写。字段名可使用 snake_case 或 camelCase（id_order 或 idOrder），重量可为字符串或数字，未知字段会被忽略。完整请求体会被保存，并原样转发给承运商。

Devuelve la lista de estados que el transportista ha registrado para el paquete, con la fecha en UTC (termina en Z), tal como la devuelve el transportista. Para la hora de Costa Rica, reste 6 horas.

Si el paquete no existe, o su transportista no tiene integración, la respuesta es 200 con el cuerpo vacío, no un 404.

Returns the list of statuses the carrier has recorded for the package, with dates in UTC (ending in Z), exactly as the carrier returns them. For Costa Rica time, subtract 6 hours.

If the package does not exist, or its carrier is not integrated, the response is 200 with an empty body, not a 404.

返回承运商为该包裹记录的状态列表，日期为 UTC（以 Z 结尾），与承运商返回的一致。哥斯达黎加时间为 UTC 减 6 小时。

如果包裹不存在，或其承运商未对接，响应为 200，响应体为空，而不是 404。

Agrupa en un manifiesto paquetes ya creados con /v1/package. En packages va la lista de sus id_order.

• Todo o nada: si algún paquete no existe, la respuesta es 400 con la lista de los que faltan, y no se crea el manifiesto.
• Lo identifica manifest.mnfs_id: un mnfs_id repetido da 400.
• Si un paquete ya estaba en otro manifiesto, pasa al nuevo.
• A cada transportista con integración solo le llegan sus paquetes, con los totales recalculados.

Las fechas van en dd/MM/yyyy h:mm AM o en ISO 8601. Crossdocker toma una fecha sin zona horaria en hora de Costa Rica (UTC−6). Para evitar dudas, envíela en ISO 8601 con desfase, por ejemplo 2026-10-20T06:30:00-06:00.

Groups into a manifest packages already created with /v1/package. packages is the list of their id_order values.

• All or nothing: if any package does not exist, the response is 400 listing the missing ones, and the manifest is not created.
• It is identified by manifest.mnfs_id: a repeated mnfs_id returns 400.
• A package that was already in another manifest moves to the new one.
• Each integrated carrier only receives its own packages, with the totals recalculated.

Dates use dd/MM/yyyy h:mm AM or ISO 8601. Crossdocker reads a date without a time zone as Costa Rica time (UTC−6). To avoid ambiguity, send ISO 8601 with an offset, for example 2026-10-20T06:30:00-06:00.

将已通过 /v1/package 创建的包裹归入一个舱单。packages 为这些包裹的 id_order 列表。

• 全部成功或全部失败：只要有一个包裹不存在，就返回 400 并列出缺失的包裹，舱单不会创建。
• 以 manifest.mnfs_id 作为标识：重复的 mnfs_id 返回 400。
• 如果某个包裹已在其他舱单中，它会转入新舱单。
• 每个已对接的承运商只会收到属于自己的包裹，合计数会重新计算。

日期格式为 dd/MM/yyyy h:mm AM 或 ISO 8601。Crossdocker 将不带时区的日期按哥斯达黎加时间（UTC−6）处理。为避免歧义，请使用带时区偏移的 ISO 8601，例如 2026-10-20T06:30:00-06:00。

Igual que la v1, pero cada paquete va como objeto, con su número de saca (int_bag_num). La cabecera manifest y las respuestas son las mismas.

Cada versión exige su formato: textos en la v1 y objetos en la v2. Si se mezclan, la respuesta es 500.

Same as v1, but each package is an object with its bag number (int_bag_num). The manifest header and the responses are the same.

Each version requires its own format: strings in v1 and objects in v2. Mixing them returns 500.

与 v1 相同，但每个包裹以对象形式提交，并带有袋号（int_bag_num）。manifest 头部和响应与 v1 相同。

每个版本必须使用自己的格式：v1 为字符串，v2 为对象。混用会返回 500。

Los códigos HTTP y la forma de cada respuesta son los de la API courier de Moovin. Los mensajes van siempre en inglés, en cualquier idioma de esta documentación, para que su sistema los pueda comparar como texto. La fecha del manifiesto repetido va en UTC (+00:00).

HTTP codes and the shape of every response are those of Moovin's courier API. Messages are always in English, whatever the language of this documentation, so your system can compare them as text. The date in the duplicate-manifest message is in UTC (+00:00).

HTTP 状态码和各响应的结构与 Moovin 快递 API 相同。错误信息一律使用英文（无论本文档以何种语言显示），以便您的系统按文本比对。舱单重复错误中的日期为 UTC（+00:00）。