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
- Pedí la habilitación de la API a api@marimpex.com.ar.
- El titular de tu cuenta entra al portal, a Mi Organización → API, y crea la clave. Se muestra una sola vez.
- 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.
- 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.