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

Crear un negocio, de práctica o en vivo

POST
/v1/ec/entities

Un negocio sandbox practica con datos inventados y es gratis; uno live se registra por su RUC, que se consulta en el registro del SRI de donde se toman sus datos, y emite en Pruebas y Producción una vez pagado.

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

Cuerpo de la solicitud

application/json

Tipos de TypeScript

Usa el tipo request body en TypeScript.

El tipo de negocio se elige al crearlo y no cambia. Un negocio sandbox inventa sus datos legales y usa el RUC de práctica 9999999999001; emite en Sandbox al instante, con numeración 001-001 para cada tipo de comprobante. Uno live es un RUC real (el de práctica se rechaza): la razón social, el régimen, la contabilidad y las obligaciones vienen del registro del SRI. Las resoluciones son obligatorias cuando el registro dice que el RUC es contribuyente especial o agente de retención. El registro no dice quién es gran contribuyente: si el RUC lo es, envía large_taxpayer_resolution y la leyenda «Gran Contribuyente» se escribe en sus facturas, liquidaciones de compra, notas de crédito y notas de débito.

El tipo de negocio se elige al crearlo y no cambia. Un negocio sandbox inventa sus datos legales y usa el RUC de práctica 9999999999001; emite en Sandbox al instante, con numeración 001-001 para cada tipo de comprobante. Uno live es un RUC real (el de práctica se rechaza): la razón social, el régimen, la contabilidad y las obligaciones vienen del registro del SRI. Las resoluciones son obligatorias cuando el registro dice que el RUC es contribuyente especial o agente de retención. El registro no dice quién es gran contribuyente: si el RUC lo es, envía large_taxpayer_resolution y la leyenda «Gran Contribuyente» se escribe en sus facturas, liquidaciones de compra, notas de crédito y notas de débito.

kind*"live"

Valores posibles

  • "live"
ruc*string
regime?string

Solo cuando el registro del SRI no dice en qué régimen está el RUC.

Valores posibles

  • "general"
  • "rimpe_emprendedor"
  • "rimpe_negocio_popular"
trade_name?string
Longitud1 <= length <= 300
head_office_address?string
Longitud1 <= length <= 300
head_office_phone?string

El teléfono de la matriz. Se imprime en el RIDE; el XML del SRI no lo lleva.

Longitud5 <= length <= 30
head_office_email?string

El correo de la matriz. Se imprime en el RIDE; el XML del SRI no lo lleva.

Longitudlength <= 254
reply_to_email?string

A dónde responden tus clientes cuando contestan un correo de Fiscalbase: va como Reply-To. Sin él, responden al remitente de Fiscalbase.

Longitudlength <= 254
footer_legend?string

Una línea que se imprime al pie de cada RIDE y de los correos a tus clientes. El XML del SRI no la lleva.

Longitud1 <= length <= 160
special_taxpayer_resolution?string
Patrón^[A-Za-z0-9]{3,5}$
withholding_agent_resolution?string
Patrón^0*[1-9]\d{0,7}$
large_taxpayer_resolution?string
Patrón^[^\n\r]*$
Longitud1 <= length <= 300

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" \  -H "Content-Type: application/json" \  -d '{    "kind": "live",    "ruc": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "object": "entity",  "kind": "sandbox",  "country": "ec",  "ruc": "string",  "legal_name": "string",  "trade_name": "string",  "head_office_address": "string",  "head_office_phone": "string",  "head_office_email": "string",  "reply_to_email": "string",  "footer_legend": "string",  "keeps_accounting": true,  "regime": "general",  "special_taxpayer_resolution": "string",  "withholding_agent_resolution": "string",  "large_taxpayer_resolution": "string",  "certificate": {    "holder": "string",    "holder_identification": "string",    "holder_identification_type": "cedula",    "kind": "natural_person",    "issuer_name": "string",    "subject": "string",    "issuer": "string",    "serial_number": "string",    "valid_from": "2019-08-24T14:15:22Z",    "valid_until": "2019-08-24T14:15:22Z"  },  "portal_shows_test": true,  "live_since": "2019-08-24T14:15:22Z",  "issuing": {    "allowed": true,    "lock": {      "code": "plan_required",      "message": "string"    }  },  "logo": {    "url": "http://example.com",    "content_type": "image/png",    "size": 0  },  "created_at": "2019-08-24T14:15:22Z"}

¿Lista para Producción? GET

Lo que debe cumplirse antes de que un negocio en vivo emita en Producción, con qué hacer en cada caso: certificado vigente, una factura autorizada en Pruebas, numeración de facturas en Producción, las direcciones del RIDE y un plan pagado y al día. `409` para un negocio de Sandbox.

Listar las entidades de la organización GET

Los negocios de práctica y los en vivo de la organización, cada uno con su `kind`.