Fiscalbase
PlataformaEstado del servicio
GuíasReferencia de la APIMCP
Catalogs

List an SRI table

GET
/v1/ec/catalogs/{table}

The codes of one of the SRI's tables, each with the value the API takes, its SRI code and name, what it means and whether it is in force; the SRI's messages with what causes each and what to do. Search them with q, such as q=efectivo in payment_methods or q=cerveza in ice. The same for every caller and environment.

Authorization

AuthorizationBearer <token>

Your API key, which acts for the one business it was created for: fb_sandbox_… issues in sandbox, fb_test_… in test, the tax authority's testing service, and fb_live_… in live.

In: header

Path Parameters

table*string

The table:

  • document_types: the six document types, by the object the API names them (tabla 3).
  • identification_types: how a buyer or supplier is identified (tabla 6).
  • taxes: the taxes a line carries: IVA, ICE and IRBPNR (tabla 16).
  • iva_rates: the IVA rates, with their percent and whether a new document may charge them (tabla 17).
  • ice: the ICE codes, by what they tax (tabla 18).
  • payment_methods: how a document is paid, with the methods withdrawn in 2016 (tabla 24).
  • iva_withholdings: the IVA withholdings and their percents (tabla 20).
  • renta_withholdings: the renta withholding codes whose percent Fiscalbase knows, with each percent by date.
  • isd_withholdings: the foreign currency outflow tax (ISD) codes, with each percent by date (tabla 20).
  • tax_support: why a withholding's support document is booked (tax_support, ATS tabla 5).
  • support_document_types: the documents a withholding, a reimbursement or a delivery note rests on (ATS tabla 4).
  • presumptive_withholdings: the withholdings fuel sellers and the press declare on their own invoices (tablas 22 and 23).
  • construction_materials: the construction materials at the 5 % IVA rate, by the auxiliary_code their line carries (tabla 31).
  • transport_services: the auxiliary_code of a commercial transport line (tabla 32).
  • fuels: the fuels, by the code a fuel line carries (tabla 30).
  • sri_messages: the SRI's reception and authorization messages, with what causes each and what to do.

Value in

  • "document_types"
  • "identification_types"
  • "taxes"
  • "iva_rates"
  • "ice"
  • "payment_methods"
  • "iva_withholdings"
  • "renta_withholdings"
  • "isd_withholdings"
  • "tax_support"
  • "support_document_types"
  • "presumptive_withholdings"
  • "construction_materials"
  • "transport_services"
  • "fuels"
  • "sri_messages"

Query Parameters

limit?integer

How many per page, from 1 to 100.

Range1 <= value <= 100
Default20
cursor?string

The next_cursor or prev_cursor of a previous response. Without a cursor, the first page.

Lengthlength <= 200
q?string

Words to find in the entry's key, code, name or description, whatever their case or accents. Each word must appear.

Length1 <= length <= 100
date?string

The day whose percents and codes in force the entries say (percent, in_force). Today in Ecuador by default.

Formatdate

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/ec/catalogs/document_types"
{  "object": "list",  "data": [    {      "object": "catalog_entry",      "table": "document_types",      "key": "string",      "code": "string",      "name": "string",      "description": "string",      "in_force": true,      "percent": "string",      "rates": [        {          "from": "2019-08-24",          "percent": "string"        }      ],      "sri_message": {        "stage": "reception",        "type": "error",        "remedy": "string"      }    }  ],  "next_cursor": "string",  "prev_cursor": "string"}

Look up a taxpayer at the SRI GET

Who an identification belongs to: the name and, for a RUC (or a `cedula` whose holder has a RUC), what the SRI records: status, regime, obligations and establishments. Use it to fill in a buyer or supplier from their identification. Responses are cached for 24 hours.

List an endpoint's deliveries GET

Each event sent to this endpoint, from newest to oldest, with each attempt.