Primeros pasos

La API de Marimpex es de solo lectura y es para empresas que despachan con Marimpex: tu sistema consulta los despachos y la facturación de tu empresa con una clave propia.

Antes de empezar

  1. Pedí la habilitación de la API a api@marimpex.com.ar.
  2. El titular de tu cuenta entra al portal, a Mi Organización → API, y crea la clave. Se muestra una sola vez.
  3. Guardá la clave en un gestor de secretos o en una variable de entorno de tu servidor. Nunca en el código ni en una app que corra en el navegador.
  4. Probala con el endpoint GET /ping, que sirve con cualquier clave válida.

Tu primera llamada

La URL base es https://mgt.marimpex.com.ar/api/v1. Todas las llamadas llevan la clave en el header Authorization.

curl -s -H "Authorization: Bearer $MGT_API_KEY" \
  https://mgt.marimpex.com.ar/api/v1/ping

Si la clave es válida, la respuesta es esta (ejemplo con datos ficticios):

GEThttps://mgt.marimpex.com.ar/api/v1/ping
Response · application/json200 OK
{
  "ok": true,
  "tenantId": "tenant-ejemplo",
  "scopes": [
    "customs:read",
    "billing:read"
  ],
  "clientLabel": "ERP de Empresa Ejemplo"
}
scopes te dice qué puede leer tu clave: customs:read (Despachos) y billing:read (Facturación). Si pedís un recurso para el que la clave no tiene permiso, la API responde 403.

Qué sigue

Las páginas de esta referencia, en orden de lectura:

También podés bajar el contrato completo en formato OpenAPI 3.1 (openapi.json) para importarlo en Postman o generar un cliente.