Providers

El Salvador: from November 3 you can migrate to electronic invoicing v2; the tax authority (Hacienda) set December 1, 2026 as the deadline to start. First request the tests at factura.gob.sv and complete them before going to production. See the migration guide · External API: migrate to /external/v2 before March 30, 2027; on January 1, 2027 the unversioned /external routes are removed. See versioning

User Manual

Mobile App

External API

Required permission: providers

These endpoints use the legacy response format { success, data, message }.

List a branch’s providers

GET /providers/branch/{branch_id}

Returns all active providers of the branch (not paginated).

Create provider

POST /providers

The body must be sent inside the data key.

{
  "data": {
    "provider_name": "Distribuidora XYZ",
    "legal_name": "Distribuidora XYZ S.A. de C.V.",
    "register_number": "54321-0",
    "tax_number": "0614-000000-000-0",
    "address": "San Salvador",
    "country_id": "uuid",
    "state_id": "uuid",
    "city_id": "uuid",
    "phone": "2222-3333",
    "email": "ventas@xyz.com",
    "business_type": "legal",
    "branch_id": "uuid"
  }
}

Field (inside `data`)	Required	Description
`provider_name`	Yes	Trade name.
`address`	Yes	Address.
`country_id`	Yes	Country. See Catalogs.
`state_id`, `city_id`	Yes (El Salvador)	Department and municipality from the catalog. Optional if the country is not El Salvador.
`state_name`, `city_name`	If the country is not El Salvador	Department or state and city or municipality as free text (maximum 120 characters).
`phone`	Yes	Phone.
`email`	Yes	Email.
`business_type`	Yes	`natural` or `legal`.
`branch_id`	Yes	Branch.
`legal_name`	No	Legal name.
`register_number`	No	NRC.
`tax_number`	No	NIT.

Location outside El Salvador. If country_id is a country other than El Salvador, state_id and city_id are optional and state_name and city_name become required (free text, maximum 120 characters each). For El Salvador, state_id and city_id remain required.

Getting Started

API v2

Billing

Human Resources

Accounting

Inventory

Projects

Receivables & Payables

Pricing & Promotions

Cash

Interactive reference

List a branch’s providers

Create provider

​List a branch’s providers

​Create provider

List a branch’s providers

Create provider