Digicust API

Digicust API

REST、SFTP、电子邮件、MCP 和 Webhooks。所有 Digicust 集成模式汇聚一处。选择最适合您技术栈的模式并开始交付。

打开Swagger UI下载 OpenAPI JSON
跳转至AuthenticationREST APISFTP电子邮件MCPWebhooks关税分类Trade compliance

两步快速入门

大多数集成可在一下午内完成。创建范围限定的API密钥，将您的客户端指向欧盟基础URL，即可开始发送案例。

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.

打开Swagger UI
Authentication

机器使用API密钥，人员使用会话

使用API密钥进行服务器间集成，使用会话令牌用于用户端应用。两者均通过相同的端点进行身份验证；选择最适合您工作流的方式即可。

  • API密钥 以 `dgc_` 为前缀，按项目划分范围，并可从平台撤销。
  • 会话令牌 由 Digicust 原生身份验证为 Web 应用、Excel 插件及任何已登录用户签发。
  • 标题 发送 `Authorization: Bearer <key>` 或 `X-API-Key: <key>`。两者均可接受。
已认证请求
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.
打开Swagger UI
api.eu.digicust.com/docs
Swagger UI

Digicust API

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

按标签、路径或操作筛选
cases
  • POST/{orgId}/{projectId}/cases/create-and-process

    请求主体 (multipart)

    • filesFile[]
    • caseDataJSON
    • strategyIdstring
    • messagestring

    响应

    • 200案例已创建并开始处理
    • 401API密钥缺失或无效
    • 429超出速率限制
    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个标签 · 82项业务
JSON YAML 立即体验
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"
    }
  }
}
电子邮件

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.
邮件 · Digicust

Re: Invoice INV-2026-0481 + packing list

ASALPHATEX SRL·To: imports-de@routing.digicust.exampleToday 09:14
自动附加到案例 DE-IMP-2026-0481

您好，

请查收发票 INV-2026-0481 的更正装箱单。第 3 行的尺寸已按您的要求更新。

顺颂商祺，
ALPHATEX SRL · logistics desk

1个附件

PDF

packing-list-INV-2026-0481.pdf

168 KB · 由Digicust代理解析

已摄入 09:14 · 案例更新于 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

包含依据、备选方案及海关预归类决定（BTI）参考的HS编码

单项或批量（最多 10 项）分类，包含明确的 GR1 至 GR6 推理、置信度评分和替代编码。使用异步批量端点处理整个目录，并配合 WebSocket 进度事件。

对商品描述进行归类
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

制裁、两用物项、禁运、CBAM、美国再出口

一个端点即可运行货物检查（出口/进口管制、禁运、CBAM、美国再出口）及全球受限方名单筛查，并提供结构化风险评分。

检查商品与当事人
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" }]
  }'

为生产环境打造

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.

安全提示： 请勿将API密钥置于客户端代码中，定期轮换密钥，并撤销任何可能泄露的密钥。若怀疑密钥泄露，请联系支持团队。密钥可即时撤销。

准备好集成了吗？

生成 API 密钥并从沙盒项目开始，或者先与我们沟通最适合您技术栈的集成方案。

打开Swagger UI联系支持