واجهة برمجة تطبيقات Digicust

واجهة برمجة تطبيقات Digicust

REST و SFTP والبريد الإلكتروني و MCP و Webhooks. كل أوضاع التكامل في Digicust في مكان واحد. اختر الطريقة التي تناسب نظامك وابدأ العمل.

فتح واجهة Swaggerتنزيل 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
Authentication

مفاتيح API للآلات، وجلسات للأشخاص

استخدم مفاتيح API لعمليات التكامل بين الخوادم ورموز الجلسة للتطبيقات الموجهة للمستخدم. كلاهما يتم التحقق منهما مقابل نفس نقاط النهاية؛ اختر ما يناسب سير العمل.

  • مفاتيح واجهة برمجة التطبيقات (API) تبدأ بالبادئة `dgc_`، ومحددة النطاق لكل مشروع، وقابلة للإلغاء من المنصة.
  • رموز الجلسة يتم إصدارها بواسطة نظام المصادقة الأصلي لـ Digicust لتطبيق الويب، وإضافة 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
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تم إنشاء الحالة وبدء المعالجة
    • 401مفتاح واجهة برمجة التطبيقات (API key) مفقود أو غير صالح
    • 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

مرفق واحد

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 }
    ]
  }
}

واجهة برمجة تطبيقات التصنيف التعريفي (Tariff classification)

رموز النظام المنسق (HS) مع التبرير والبدائل ومراجع معلومات التعريفة الملزمة (BTI)

تصنيف عنصر واحد أو دفعة (تصل إلى 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" }'

واجهة برمجة تطبيقات الامتثال التجاري

العقوبات، الاستخدام المزدوج، الحظر، 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اتصل بالدعم