API de Digicust

La API de Digicust

REST, SFTP, correo electrónico, MCP y Webhooks. Todos los modos de integración de Digicust en un solo lugar. Elija la modalidad que mejor se adapte a su infraestructura y envíe.

Abrir interfaz SwaggerDescargar JSON de OpenAPI
Ir aAuthenticationREST APISFTPCorreo electrónicoMCPWebhooksClasificación de tarifaTrade compliance

Primeros pasos en dos pasos

La mayoría de las integraciones están activas en una tarde. Cree claves API con alcance definido, apunte su cliente a la URL base de la UE y comience a enviar casos.

1. Create API keys

Generate scoped, revocable API keys directly in the platform. Use them for server-to-server integrations, ERP feeds or automation scripts.

Open the platform

2. Explore the OpenAPI spec

Browse every endpoint in the interactive Swagger UI, or download the full OpenAPI 3.0 specification as JSON or YAML.

Abrir interfaz Swagger
Authentication

Claves API para máquinas, sesiones para personas

Utilice claves API para integraciones servidor a servidor y tokens de sesión para aplicaciones orientadas al usuario. Ambos se autentican contra los mismos puntos finales; elija lo que mejor se adapte al flujo de trabajo.

  • Claves API están prefijados con `dgc_`, limitados por proyecto y son revocables desde la plataforma.
  • Tokens de sesión son emitidos por la autenticación nativa de Digicust para la aplicación web, el complemento de Excel y cualquier usuario que haya iniciado sesión.
  • Encabezados Envíe `Authorization: Bearer <key>` o `X-API-Key: <key>`. Se acepta cualquiera de los dos.
Solicitud autenticada
curl -X GET "https://api.eu.digicust.com/api/{orgId}/{projectId}/cases" \
  -H "Authorization: Bearer dgc_1234567890abcdef1234567890abcdef"
REST API

Full REST API with OpenAPI 3.0

Drive every Digicust capability over standard REST. Cases, conversations, strategies, integrations, mappings, MCP servers, API keys, tariff classification and trade-compliance checks are all addressable with the same authentication and shape.

  • Authenticate with `Authorization: Bearer dgc_…` API keys or a session token from the Digicust login.
  • One-step `cases/create-and-process` accepts files plus metadata in a single multipart request.
  • Async `classify-batch` for large catalogues with WebSocket progress events.
  • Polling and webhook patterns documented with copy-paste JS and Python examples.
  • Full OpenAPI spec downloadable as JSON or YAML.
Abrir interfaz Swagger
api.eu.digicust.com/docs
Interfaz de usuario Swagger

Digicust API

v3.0.0 · OpenAPI 3.0 · api.eu.digicust.com

Filtrar por etiqueta, ruta u operación
cases
  • POST/{orgId}/{projectId}/cases/create-and-process

    Cuerpo de la solicitud (multipart)

    • filesFile[]
    • caseDataJSON
    • strategyIdstring
    • messagestring

    Respuestas

    • 200Caso creado y procesamiento iniciado
    • 401Clave API faltante o no válida
    • 429Límite de tasa excedido
    cURLmultipart/form-data
    curl -X POST "https://api.eu.digicust.com/api/{orgId}/{projectId}/cases/create-and-process" \
  -H "Authorization: Bearer dgc_your-api-key" \
  -F "files=@invoice.pdf" \
  -F 'caseData={"reference":"CASE-2026-001"}'
  • GET/{orgId}/{projectId}/cases/{caseId}
  • POST/{orgId}/{projectId}/classify-batch
  • POST/{orgId}/{projectId}/trade-compliance/check
  • POST/{orgId}/{projectId}/integrations
  • GET/organizations/{orgId}/projects/{projectId}/api-keys
13 etiquetas · 82 operaciones
JSON YAML Pruébelo en vivo
SFTP

SFTP for legacy file flows

When an ERP, customs broker or partner can only speak files, Digicust drops processed cases on SFTP and picks up new ones from a watched folder. Same pipelines, same audit trail, no new schema for them to learn.

  • Outbound: push processed declarations, structured payloads or PDF outputs to your SFTP server.
  • Pre-built SFTP profiles for Scope, DAKOSY, E2OPEN, MERCURIO and DBH.
  • Inbound: drop documents into a strategy folder; Digicust creates the case automatically.
  • Password and key-based authentication with optional passphrase.
  • Optional FTP fallback for partners that have not migrated to SFTP.
Configure an SFTP integration
{
  "name": "Export to SFTP",
  "type": "SFTP",
  "enabled": true,
  "config": {
    "sftp": {
      "host": "sftp.example.com",
      "port": 22,
      "username": "sftp-user",
      "privateKeyBase64": "LS0tLS1CRUdJTi…",
      "remotePath": "/exports/customs"
    }
  }
}
Correo electrónico

Email gateway for documents and follow-ups

Every strategy gets its own ingest email address; every case gets its own follow-up address. Send PDFs, EML, MSG or even photos and Digicust opens the case, parses attachments, classifies the goods and replies in your team's voice.

  • Per-strategy ingest address creates new cases automatically.
  • Per-case reply address attaches incoming mail to the open case.
  • Document control agent can chase suppliers, brokers or carriers in their own language.
  • Notifications on processing start, completion and SLA breaches.
  • Custom email gateway endpoint for teams that want to relay through their own MTA.
Correo · Digicust

Re: Invoice INV-2026-0481 + packing list

ASALPHATEX SRL·To: imports-de@routing.digicust.exampleToday 09:14
Adjuntado automáticamente al caso DE-IMP-2026-0481

Hola,

adjunto encontrará la lista de empaque corregida para la factura INV-2026-0481. Las dimensiones de la línea 3 han sido actualizadas según lo solicitado.

Atentamente,
ALPHATEX SRL · logistics desk

1 adjunto

PDF

packing-list-INV-2026-0481.pdf

168 KB · Analizado por el agente de Digicust

Ingerido 09:14 · caso actualizado 09:14
MCP

Model Context Protocol, first-class

Digicust speaks MCP, the open protocol that connects AI agents to external tools. Plug your own MCP server in to extend the Digicust agent with custom tools and data sources, or expose Digicust's customs tools to your own LLM apps.

  • SSE, HTTP and stdio transports supported.
  • Bring your own auth: bearer token, API key or basic.
  • Per-strategy enabling so the agent only sees the tools it should use.
  • Available tools surface live during case processing, no redeploy required.
  • Use the Digicust MCP server from any LLM app to run customs workflows on demand.
Register an MCP server
{
  "name": "Custom Tools Server",
  "transport": "sse",
  "url": "https://your-mcp-server.com/sse",
  "auth": { "type": "bearer", "token": "your-mcp-token" },
  "enabled": true
}
Webhooks

Webhooks for outbound events

Get notified the moment a case is processed, a finding is raised or a strategy event fires. Webhooks are configured per-strategy and can be paired with mappings to deliver exactly the payload your system expects.

  • POST/PUT/GET/DELETE delivery with custom headers.
  • None, Basic, Bearer or Keycloak OAuth2 authentication.
  • Pair with a mapping to transform the case into your downstream schema.
  • Automatic retries (3 attempts, 60s timeout) with delivery audit log.
  • Receive base64-encoded attachments alongside the structured payload.
Webhook payload (excerpt)
{
  "caseId": "6501234567890abcdef12345",
  "reference": "CASE-2026-001",
  "timestamp": "2026-01-15T10:35:00Z",
  "data": {
    "invoiceNumber": "INV-2026-001",
    "items": [
      { "description": "Widget A", "hsCode": "8473.30.20", "value": 2550.00 }
    ]
  }
}

API de clasificación arancelaria

Códigos SA con razonamiento, alternativas y referencias de IAV

Clasificación de artículo único o por lotes (hasta 10) con razonamiento explícito de GR1 a GR6, puntuaciones de confianza y códigos alternativos. Utilice el endpoint de lotes asíncronos para catálogos completos con eventos de progreso WebSocket.

Clasificar una descripción de mercancía
curl -X POST "https://api.eu.digicust.com/api/{orgId}/{projectId}/tools/tariff-classification" \
  -H "Authorization: Bearer dgc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{ "goodsDescription": "USB-A to USB-C cable, 2m, copper" }'

API de cumplimiento comercial

Sanciones, doble uso, embargos, CBAM, reexportación de EE. UU.

Un punto de conexión ejecuta comprobaciones de artículos (controles de exportación/importación, embargos, CBAM, reexportación a EE. UU.) y cribado de partes en listas globales de partes denegadas, con una puntuación de riesgo estructurada.

Comprobar artículos y partes
curl -X POST "https://api.eu.digicust.com/api/{orgId}/{projectId}/trade-compliance/check" \
  -H "Authorization: Bearer dgc_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "itemChecks": [{ "customsTariffNumber": "8456301000", "destinationCountry": "CN" }],
    "partyChecks": [{ "name": "Acme Corporation Ltd.", "role": "buyer" }]
  }'

Diseñado para la producción

Global coverage

Submission-ready data for ATLAS, AES, NCTS, ASYCUDA, DAKOSY, AEB, Format, Scope, Mercurio and more across 30+ countries.

Async + sync

Sync endpoints for short-lived calls, async pipelines for batches and long-running classifications, with WebSocket progress events.

Enterprise security

API key plus session-based authentication, scoped keys, instant revocation, audit log on every action, GDPR-aligned EU hosting.

Nota de seguridad: Mantenga las claves API fuera del código del lado del cliente, rótelas periódicamente y revoque cualquier clave que pueda haberse filtrado. Póngase en contacto con el soporte si sospecha de un compromiso. Las claves pueden revocarse al instante.

¿Listo para integrar?

Genere una clave API y comience con un proyecto sandbox, o hable primero con nosotros sobre la forma de integración que mejor se adapte a su infraestructura.

Abrir interfaz SwaggerContactar con soporte