DUMIA API — Maroc

Classement NGP à 10 chiffres, justification RGI, droits et taxes, organismes de contrôle et documents, pour l'importation au Maroc.
NGP (10-digit) classification, GRI justification, duties and taxes, control bodies and documents for imports into Morocco.

1. Clé sandbox / Sandbox key

Gratuite et immédiate : la clé est envoyée à votre adresse. En sandbox, /v1/classify répond à partir d'un catalogue d'exemples ; /v1/codes et /v1/liquidation sont réels.
Free and instant, sent to your e-mail. In the sandbox, /v1/classify answers from a catalogue of examples; /v1/codes and /v1/liquidation are live.

2. Classer une marchandise / Classify

curl https://api.dumiangp.com/v1/classify \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"description": "Groupe électrogène", "value": 8000, "currency": "CAD",
       "exchange_rate": 7.2, "origin": "CN"}'

Réponse (extrait) / Response (excerpt):

{
  "id": "cls_…", "status": "review_required", "code": "8502112000",
  "question": { "text": "Quel moteur et quelle puissance ?",
                "options": [ {"index": 0, "label": "Diesel, jusqu'à 75 kVA"}, … ] },
  "rgi": { "rules_applied": ["RGI 1", "RGI 6"], "justification": "…",
           "notes_cited": [ {"ref": "…", "extract": "…"} ], "why_not_alternatives": [ … ] },
  "duties": { "mfn_rate_pct": 2.5, "applicable_rate_pct": 2.5, "agreement": "…" },
  "liquidation": { "base_value": 57600.0, "di": …, "tva": …, "timbre": …, "total_to_pay": … },
  "control_bodies": [ … ], "documents": [ … ], "alerts": [ … ],
  "disclaimer": "Résultat indicatif … à valider par un professionnel …"
}

`status`	Sens / Meaning
`validated`	Code retenu (règle, retour d'expert ou IA concordante). Code retained.
`review_required`	Code provisoire : répondez à `question` ou faites vérifier. Provisional: answer the question or have it checked.
`not_recognized`	La désignation ne décrit pas une marchandise identifiable. Not an identifiable good.

3. Répondre à la question / Answer the question

curl https://api.dumiangp.com/v1/classify/cls_…/answer \
  -H "Authorization: Bearer sk_test_…" -H "Content-Type: application/json" \
  -d '{"option": 0}'

Une option qui porte un code se résout sans IA. Les autres réponses, et une réponse libre ("text"), relancent le classement : clés de production uniquement. En sandbox, essayez « Pièces détachées ».
An option carrying a code resolves without AI; other answers and free text re-run the classification (live keys only). In the sandbox, try « Pièces détachées ».

4. Code connu / Known code

curl "https://api.dumiangp.com/v1/codes/9503009412?origin=ES" -H "Authorization: Bearer sk_test_…"

curl https://api.dumiangp.com/v1/liquidation -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"code": "9503009412", "value": 20000, "origin": "ES"}'

5. À savoir / Good to know

Valeur : valeur en douane (CAF). Autre devise que le MAD : donnez exchange_rate (MAD pour 1 unité). Customs (CIF) value; give exchange_rate for non-MAD currencies.
Véhicules : l'ADII taxe en général sur sa propre valeur de référence (par modèle et âge), pas sur la facture ; la liquidation repose sur la valeur fournie. Vehicles: ADII usually taxes its own reference value, not the invoice.
RGI : "rgi": false pour une réponse plus rapide (~5 s de moins). Set "rgi": false for a faster answer.
Limites : sandbox 200 appels/jour, 30/min. Production : selon contrat. Sandbox 200 calls/day, 30/min.
Données : vos requêtes restent privées et servent uniquement au contrôle qualité de DUMIA. Requests stay private, used only for DUMIA's quality review.
Référence complète / Full reference : /docs (OpenAPI).

Résultats indicatifs, à valider par un professionnel (transitaire agréé). Clé de production : répondez au message qui vous a apporté la clé sandbox. Live key: reply to your sandbox-key e-mail.