KilaSifen Docs

Emisores

GET/v1/emitters

Emisores 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
X-API-Key<token>

Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.

In: header

Query Parameters

external_id?|null
ruc?|null
limit?Limit
Range1 <= value <= 200
Default50

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"
{  "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"      }    ]  }}
POST/v1/emitters

Da 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
X-API-Key<token>

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"    }  }}
GET/v1/emitters/{emitter_id}

Scope: tenant:read (también platform:admin).

Authorization

KilaApiKey
X-API-Key<token>

Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.

In: header

Path Parameters

emitter_id*Emitter Id

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"    }  }}
PATCH/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
X-API-Key<token>

Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.

In: header

Path Parameters

emitter_id*Emitter Id

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"    }  }}
POST/v1/emitters/{emitter_id}/deactivate

Scope: tenant:write (también platform:admin).

Authorization

KilaApiKey
X-API-Key<token>

Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.

In: header

Path Parameters

emitter_id*Emitter Id

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"    }  }}
GET/v1/emitters/{emitter_id}/health

Scope: tenant:read (también platform:admin).

Authorization

KilaApiKey
X-API-Key<token>

Credencial privada del consumidor. Nunca la expongas en un navegador ni en una app cliente.

In: header

Path Parameters

emitter_id*Emitter Id

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"    }  }}