Emisores
/v1/emittersEmisores del consumidor de la credencial, del más nuevo al más viejo (con platform:admin, todos). external_id y ruc (con o sin DV) filtran; sirven para recuperar el emitter_id de un alta cuya respuesta se perdió.
Scope: tenant:read (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Query Parameters
1 <= value <= 20050Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/emitters"{ "correlation_id": "string", "data": { "emitters": [ { "created_at": "2019-08-24T14:15:22Z", "csc_configured": true, "csc_id": "string", "dv": "string", "external_id": "string", "fiscal_profile": { "actividades_economicas": [ { "codigo": "string", "descripcion": "string" } ], "domicilio": { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "numero_casa": "string", "telefono": "string" }, "establecimientos": [ { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "establecimiento": "string", "numero_casa": "string", "telefono": "string" } ], "nombre_fantasia": "string", "tipo_contribuyente": 1, "tipo_regimen": 1 }, "fiscal_profile_complete": true, "id": "string", "legal_name": "string", "ruc": "string", "status": "string", "tax_environment": "string", "updated_at": "2019-08-24T14:15:22Z" } ] }}/v1/emittersDa de alta un emisor (un RUC). Con emitters:create el emisor queda siempre a nombre del consumidor de la credencial: es el alta autoservicio de los clientes de un ERP. Con platform:admin puede asignarse a cualquier consumidor con owner_consumer_id. RUC+DV y external_id son únicos en la plataforma (409); si se pierde la respuesta, el emisor se recupera con GET /v1/emitters?external_id=.
Scope: emitters:create (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Alta de un emisor.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/emitters" \ -H "Content-Type: application/json" \ -d '{ "dv": "string", "legal_name": "string", "ruc": "string", "tax_environment": "test" }'{ "correlation_id": "string", "data": { "emitter": { "created_at": "2019-08-24T14:15:22Z", "csc_configured": true, "csc_id": "string", "dv": "string", "external_id": "string", "fiscal_profile": { "actividades_economicas": [ { "codigo": "string", "descripcion": "string" } ], "domicilio": { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "numero_casa": "string", "telefono": "string" }, "establecimientos": [ { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "establecimiento": "string", "numero_casa": "string", "telefono": "string" } ], "nombre_fantasia": "string", "tipo_contribuyente": 1, "tipo_regimen": 1 }, "fiscal_profile_complete": true, "id": "string", "legal_name": "string", "ruc": "string", "status": "string", "tax_environment": "string", "updated_at": "2019-08-24T14:15:22Z" } }}/v1/emitters/{emitter_id}Scope: tenant:read (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/emitters/string"{ "correlation_id": "string", "data": { "emitter": { "created_at": "2019-08-24T14:15:22Z", "csc_configured": true, "csc_id": "string", "dv": "string", "external_id": "string", "fiscal_profile": { "actividades_economicas": [ { "codigo": "string", "descripcion": "string" } ], "domicilio": { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "numero_casa": "string", "telefono": "string" }, "establecimientos": [ { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "establecimiento": "string", "numero_casa": "string", "telefono": "string" } ], "nombre_fantasia": "string", "tipo_contribuyente": 1, "tipo_regimen": 1 }, "fiscal_profile_complete": true, "id": "string", "legal_name": "string", "ruc": "string", "status": "string", "tax_environment": "string", "updated_at": "2019-08-24T14:15:22Z" } }}/v1/emitters/{emitter_id}Cambiar csc o csc_id exige además el scope secrets:write.
Scope: tenant:write (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Cambios de un emisor; los campos omitidos no cambian.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/emitters/string" \ -H "Content-Type: application/json" \ -d '{}'{ "correlation_id": "string", "data": { "emitter": { "created_at": "2019-08-24T14:15:22Z", "csc_configured": true, "csc_id": "string", "dv": "string", "external_id": "string", "fiscal_profile": { "actividades_economicas": [ { "codigo": "string", "descripcion": "string" } ], "domicilio": { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "numero_casa": "string", "telefono": "string" }, "establecimientos": [ { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "establecimiento": "string", "numero_casa": "string", "telefono": "string" } ], "nombre_fantasia": "string", "tipo_contribuyente": 1, "tipo_regimen": 1 }, "fiscal_profile_complete": true, "id": "string", "legal_name": "string", "ruc": "string", "status": "string", "tax_environment": "string", "updated_at": "2019-08-24T14:15:22Z" } }}/v1/emitters/{emitter_id}/deactivateScope: tenant:write (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/emitters/string/deactivate"{ "correlation_id": "string", "data": { "emitter": { "created_at": "2019-08-24T14:15:22Z", "csc_configured": true, "csc_id": "string", "dv": "string", "external_id": "string", "fiscal_profile": { "actividades_economicas": [ { "codigo": "string", "descripcion": "string" } ], "domicilio": { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "numero_casa": "string", "telefono": "string" }, "establecimientos": [ { "ciudad": 1, "complemento_1": "string", "complemento_2": "string", "denominacion_sucursal": "string", "departamento": 1, "descripcion_ciudad": "string", "descripcion_departamento": "string", "descripcion_distrito": "string", "direccion": "string", "distrito": 1, "email": "string", "establecimiento": "string", "numero_casa": "string", "telefono": "string" } ], "nombre_fantasia": "string", "tipo_contribuyente": 1, "tipo_regimen": 1 }, "fiscal_profile_complete": true, "id": "string", "legal_name": "string", "ruc": "string", "status": "string", "tax_environment": "string", "updated_at": "2019-08-24T14:15:22Z" } }}/v1/emitters/{emitter_id}/healthScope: tenant:read (también platform:admin).
Authorization
KilaApiKey Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/emitters/string/health"{ "correlation_id": "string", "data": { "health": { "certificate_valid_until": "2019-08-24T14:15:22Z", "checked_at": "2019-08-24T14:15:22Z", "emitter_id": "string", "emitter_status": "string", "has_active_certificate": true, "has_active_stamping": true, "last_document_id": "string", "last_document_status": "string", "queue_failed_count": 0, "queue_queued_count": 0, "queue_retry_count": 0, "stamping_number": "string", "stamping_valid_on": "2019-08-24" } }}