Commons
Invoice Categories
GET
/v1/core/commons/invoice-categories
This endpoint is public — no API key required.
Returns the supported invoice categories.
json
{
"success": true,
"message": "Success",
"data": {
"invoice_categories": [
{ "label": "Blank", "value": "Blank" },
{ "label": "B2B", "value": "B2B" },
{ "label": "B2C", "value": "B2C" },
{ "label": "B2G", "value": "B2G" }
]
}
}
Integration Enums
GET
/v1/core/commons/enums
Requires an
x-api-key header, unlike Invoice Categories above.
Returns the valid option lists for ERP system, authentication type, and data format used by a taxpayer's
integration record (erp_system, auth_type, data_format). These are
configured via the portal's dashboard rather than this API — the System Integrator API's
Update Webhook endpoint
only manages webhook_url/enabled_events on top of whatever ERP configuration
already exists.
label values are the enum's case name uppercased with spaces (e.g. DYNAMICS FO,
API KEY) — not Title Case. Use value for the actual field value you send back.
json
{
"success": true,
"message": "Success",
"data": {
"erp_systems": [
{ "label": "ODOO", "value": "odoo" },
{ "label": "ORACLE", "value": "oracle" },
{ "label": "SAGE", "value": "sage" },
{ "label": "DYNAMICS FO", "value": "dynamics_fo" },
{ "label": "DYNAMICS BC", "value": "dynamics_bc" },
{ "label": "BESPOKE", "value": "custom" }
],
"auth_types": [
{ "label": "NONE", "value": "none" },
{ "label": "BASIC", "value": "basic" },
{ "label": "API KEY", "value": "api_key" },
{ "label": "OAUTH2", "value": "oauth2" },
{ "label": "NTLM", "value": "ntlm" },
{ "label": "CLIENT CREDENTIALS", "value": "client_credentials" }
],
"data_formats": [
{ "label": "REST", "value": "rest" },
{ "label": "SOAP", "value": "soap" },
{ "label": "GRAPHQL", "value": "graphql" },
{ "label": "ODATA", "value": "odata" },
{ "label": "JSON RPC", "value": "jsonrpc" }
]
}
}