APIs

Seamless
Integration

API Preview

{
  "trnx_id": "1234567890",
  "total_tax_value": 150,
  "total_value": 1150,
  "tax_payer_tin": "7777788993",
  "info": {
    "ItemList": [
      {
        "ItemCode": "1111",
        "ProductDescription": "item1",
        "PreTaxValue": 1000,
        "TaxAmount": 150
      }
    ]
  }
}

TAP TO VIEW FEATURES→

Example of the data structure provided by our public API. Includes transaction IDs, tax totals, and detailed itemization for smooth backend integration.

Authentication

curl -X POST https://trcp-2.adc.com.et/authenticate \
--insecure \
-u adc_erp_api:adc_erp_api_pass \
-H "Content-Type: application/json" \
-d '{"tin_no": "7777788993"}'

TAP TO VIEW FEATURES→

Secure your connection by authenticating with your registered TIN. This returns a bearer token required for all subsequent transaction requests.

Registration

curl -X POST https://trcp-2.adc.com.et/receive_request \
--insecure \
-H "Authorization: Bearer [TOKEN]" \
-d '{"device_id":"0964400970","trnx_id":"123..."}'

TAP TO VIEW FEATURES→

Direct registration with the Ministry of Revenues. Automated sync ensures your business remains fully compliant with fiscal regulations.

Cancellation

curl -X POST https://trcp-2.adc.com.et/cancel \
--insecure \
-H "Authorization: Bearer [TOKEN]" \
-d '{"invoice_irn":"f8a7303e95..."}'

TAP TO VIEW FEATURES→

Easily void or cancel invoices. By providing the Invoice Reference Number (IRN), the specific record is updated across the synchronized ledger.