Turn Morocco's SIMPL tax services into an API

What you can build on SIMPL

• Get your Simpl-TVA declarations

  Build this

  Reads the history of your deposits in Simpl-TVA: each TVA declaration with its period, year, régime and where it stands, from Brouillon (draft) to deposited.

  Takes

  Year, status (optional)

  Returns

  Period, year, régime, declaration type, status, deposit date, TVA paid, payment mode

• Check EDI files in Suivi Envoi EDI

  Build this

  Reads the Suivi Envoi EDI dashboard in Simpl-TVA: each zipped XML file you sent, when it was received and the result of the DGI's checks.

  Takes

  Period, year

  Returns

  File name, file type, reception date, processing result, error message, declaration period

• Get an attestation de régularité fiscale

  Build this

  Requests the Demande d'attestation de régularité fiscale in Simpl-Attestation with Soumission aux marchés ticked and reads what it says.

  Takes

  Nothing

  Returns

  Attestation number, date issued, in good standing, missing declarations, unpaid taxes, verification code

• Upload a relevé des déductions to a draft

  Build this

  Opens the TVA declaration for a period in Brouillon, sends a zipped XML relevé des déductions through Envoi EDI and leaves the draft for a person to check.

  Takes

  Period, year, ZIP file

  Returns

  File name, reception date, format check result, declaration status

Automate SIMPL with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• TVA declarations not yet deposited

  Build this

  Starts

  Every weekday at 8:00

  Step 1

  Get your Simpl-TVA declarations for the current year.

  Step 2

  Keep the ones in Brouillon or waiting for validation.

  Step 3

  Email you the list with period, régime, status and declaration type.

• EDI check results, posted to your accounting team

  Build this

  Starts

  Every hour

  Step 1

  Check Suivi Envoi EDI for the current period.

  Step 2

  Keep the files whose processing result changed since the last run.

  Step 3

  Post each file's name, type, result and error message to your accounting team's webhook.

• Attestation de régularité fiscale for a tender

  Build this

  Starts

  When your system calls the workflow's webhook with a tender reference

  Step 1

  Get an attestation de régularité fiscale.

  Step 2

  Stop and email you the missing declarations and unpaid taxes when it is not en règle.

  Step 3

  Otherwise post the attestation number, date and code de vérification to your webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get your Simpl-TVA declarations” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tva.tax.gov.ma/get_tva_declarations",
    "input": {
      "year": 2026,
      "status": "Brouillon"
    }
  }'

{
  "status": "completed",
  "data": {
    "company": "Acme Maroc SARL",
    "year": 2026,
    "declarations": [
      {
        "period": "10",
        "year": 2026,
        "regime": "Mensuel",
        "declaration_type": "Initiale",
        "status": "Brouillon",
        "deposit_date": null,
        "tva_paid": null,
        "payment_mode": null
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

SIMPL’s own options

The DGI's SIMPL pages describe no API. What they offer is EDI: Simpl-TVA accepts zipped XML files in the formats of the DGI's cahiers des charges, which a user uploads in the portal and which load into a draft declaration that still has to be validated and deposited there. Attestations are issued online through Simpl-Attestation.

Read on November 12, 2026: Guide de la télédéclaration TVA, Guide d'inscription aux téléservices SIMPL-Professionnels, Guide de Simpl-Attestation.

Signing in to SIMPL

SIMPL signs each user in with the login and password emailed after adhesion, then a 6-digit code d'authentification (authentication code) sent to that user's email address at each sign-in. With Fous you sign in once through SIMPL's own sign-in with your own user: the login is sealed with AES-256, the emailed code is handled, and an expired session is signed back in.

Worth knowing

One person enters, another deposits

Users get profiles such as Saisie, Validation, Dépôt and Consultation. The rédacteur submits pour validation and the responsable clicks Déposer or Invalider. A method does only what its user can.

An EDI file only fills a draft

The ZIP must hold valid XML with the identifiant fiscal, période, année and régime. Once its checks pass, the data loads into the declaration in Brouillon, which still needs Calculer, Valider and Déposer.

The représentant manages every user

Users, passwords and email addresses are managed by the company's représentant in Simpl-Adhésion. A new RIB for bank debit also needs the bank authorisation form filed at the direction régionale des impôts.

A second filing becomes complémentaire

If a declaration is already deposited for the period, SIMPL warns that the new one will be a déclaration complémentaire. Déclaration Périodes antérieures is for earlier periods not yet deposited.

More in Government: Middle East and Africa

• CAC Company Registration Portal
• CIPC eServices
• GDRFA Dubai Smart Services
• eTIMS
• Rev360
• Qiwa
• ICP Smart Services
• KRA iTax
• SARS eFiling
• Egyptian Tax Authority e-Services
• ZATCA e-Services
• uFiling
• EmaraTax
• Mudad

Other industries: NEN, impots.gouv.fr espace professionnel, eFileTexas, CommBroker, SAM.gov, MyFloridaMarketPlace Vendor Information Portal.