Fiscalbase
PlataformaEstado de la API
GuíasReferencia de la API
Emisores

Abrir una numeración

POST
/v1/ec/entities/{id}/series

En el ambiente de tu clave. Fuera de Sandbox, el establecimiento debe constar abierto para el RUC en el registro del SRI; su dirección sale de ahí.

Autorización

AutorizaciónBearer <tu clave API>

Tu clave API: fb_sandbox_… emite en Sandbox, fb_test_… en test, el servicio de pruebas de la autoridad tributaria, y fb_live_… en live, su producción.

En: header

Parámetros de ruta

id*string
Formatouuid

Cuerpo de la solicitud

application/json

Tipos de TypeScript

Usa el tipo request body en TypeScript.

document_type*string

Valores posibles

  • "invoice"
  • "credit_note"
  • "debit_note"
  • "withholding"
  • "delivery_note"
  • "purchase_settlement"
establishment*string
Patrón^\d{3}$
emission_point*string
Patrón^\d{3}$
establishment_address?string
Longitud1 <= length <= 300
establishment_name?string

Un nombre para el establecimiento, que no se imprime en los comprobantes. Todas las series del establecimiento lo comparten: se guarda en cada una.

Longitud1 <= length <= 80
emission_point_name?string

Un nombre para el punto de emisión, que no se imprime.

Longitud1 <= length <= 80
next_number?integer

El primer número a entregar, si otro sistema ya usó los anteriores. Por defecto, 1.

Rango1 <= value <= 999999999

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/ec/entities/497f6eca-6276-4993-bfeb-53cbbbba6f08/series" \  -H "Content-Type: application/json" \  -d '{    "document_type": "invoice",    "establishment": "string",    "emission_point": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "object": "series",  "entity_id": "8161163a-f227-466f-bc01-090a01e80165",  "country": "ec",  "environment": "sandbox",  "document_type": "invoice",  "establishment": "string",  "emission_point": "string",  "establishment_address": "string",  "establishment_name": "string",  "emission_point_name": "string",  "last_number": 0,  "issued_today": 0,  "active": true,  "created_at": "2019-08-24T14:15:22Z"}

Actualizar una entidad PATCH

Solo cambia los campos que envías. En un negocio en vivo, la razón social, el régimen y si lleva contabilidad vienen del registro del SRI y no se editan (`422`). Los comprobantes ya emitidos conservan los datos con que se firmaron.

Listar la numeración de una entidad GET

Cada numeración con su ambiente, su último número entregado y cuántos comprobantes emitió hoy.