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

Listar los certificados de firma

GET
/v1/ec/entities/{id}/certificates

Los certificados que subió la entidad, del más reciente al más antiguo, con cuándo se reemplazó cada uno: current marca el que firma y los demás son el historial. Solo lo que dicen: el .p12 y su clave quedan sellados y la API no los devuelve. Un negocio de Sandbox no tiene ninguno.

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

Parámetros de consulta

limit?integer

Cuántos por página, de 1 a 100.

Rango1 <= value <= 100
Por defecto20
cursor?string

El next_cursor o el prev_cursor de una respuesta anterior. Sin cursor, la primera página.

Longitudlength <= 200

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/ec/entities/497f6eca-6276-4993-bfeb-53cbbbba6f08/certificates"
{  "object": "list",  "data": [    {      "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",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "object": "certificate",      "uploaded_at": "2019-08-24T14:15:22Z",      "replaced_at": "2019-08-24T14:15:22Z",      "current": true    }  ],  "next_cursor": "string",  "prev_cursor": "string"}

Cambiar un punto de emisión PATCH

Su nombre o su código, en todas las numeraciones del punto en el ambiente de tu clave. El código solo cambia mientras el punto no haya numerado ningún comprobante (`409`).

Subir el certificado de firma POST

Se verifican el .p12 y su clave (el certificado debe ser de la entidad y estar vigente) y se sellan: la API ya no puede abrirlos; solo el proceso que firma. El último certificado que subes firma los comprobantes de Pruebas y Producción mientras está vigente; cuando vence no firma ninguno anterior, aunque siga vigente: sube uno nuevo.