Servicio De Impuestos Internos (SII) Situación Tributaria - Chile
Para integrar el servicio de Servicio De Impuestos Internos (SII) Situación Tributaria - Chile en su sistema. Primero, obtenga su API key de Apitude, luego envíe una solicitud POST a Aptitude ... ¡Y eso es todo!.
Esa solicitud POST debe devolver lo siguiente
{
"message": "Request processed successfully",
"url": "/api/v1.0/requests/sii-situacion-tributaria-cl/e0606c19-a32d-410f-b2eb-d57a665677bc/",
"request_id": "e0606c19-a32d-410f-b2eb-d57a665677bc"
}
Esta respuesta contendrá un ID de solicitud único que debe utilizar enviando un GET de la siguiente manera
¿Cómo se ve la respuesta?
{
"result": {
"data": {
"name": "MARIA DOE SKYWALKER",
"documents": [
{
"date": "2021",
"name": "BOLETAS DE HONORARIOS ELECTRONICAS"
}
],
"economic_activities": [
{
"code": "960909",
"date": "2011-12-19",
"name": "OTRAS ACTIVIDADES DE SERVICIOS PERSONALES N.C.P.",
"category": "SEGUNDA",
"affects_iva": false
}
],
"small_business_status": false,
"reported_tax_activities": true,
"date_of_first_tax_activity": "2011-12-19",
"enabled_to_pay_taxes_in_foreign_currency": false
},
"error": "",
"end_at": "2020-05-30 21:54:06.453355",
"status": 200,
"message": "successful",
"queried_by": "YOUR-USER",
"service_name": "sii-situacion-tributaria-cl"
},
"message": "Request completed"
}
Ok, pero ¿qué significa cada campo en ese JSON?
Las partes generales:
message:
El mensaje es unstring
generado por Aptitude con un texto informativo sobre la solicitud..result:
El resultado contiene la parte principal de la solicitud..result.error:
El error es unstring
generado por Aptitude para la solicitud. Si todo funcionó, estará en blanco.result.message:
El mensaje es unstring
con dos opcionessuccessful
ounsuccessful
dependiendo de cómo terminó su solicitud.result.queried_by:
El campo queried_by es unstring
que indica que usuario creo la solicitud.result.end_at:
El campo end_at es unstring formatted date
que indica en qué momento la solicitud terminó en Apitude.result.service_name:
El campo service_name es unstring
que retorna el servicio llamado. Para este servicio siempre serásii-situacion-tributaria-cl
.result.status:
El campo estado, es unentero
cuyo valor representa si el servicio retorno informacion para la solicitud enviada. Puede tomar alguno de los siguientes valores:200
: El servicio devolvió datos con la respuesta para la información que se envió en la solicitud.404
: El servicio no devolvió datos con la respuesta para la información que se envió en la solicitud.400
: El servicio no se inició porque su entrada no era válida.500
: Apitude intentó ejecutar tu solicitud, sin embargo, el servicio que utiliza Apitude para ejecutar su solicitud no funciona. Espera un poco y vuelve a intentarlo, Apitude no te cobrará solicitudes con este código.
Dependiendo del servicio, quieres que devuelva diferente códigos. Por ejemplo, si está pasando al usuario por un proceso de vinculación y desea que este quede en su lista blanca, debe buscar un
404
, porque un200
significaría que el usuario está de hecho en la lista. Otros casossin embargo, como crear objetos con el nombre de un usuario, desea que el código sea200
, ya que implicará que la creación fue un éxito.
Los datos en la respuesta:
-
data.name:
El name es unacadena
con el nombre completo del contribuyente correspondiente al RUT del usuario enviado. -
data.reported_tax_activities:
El reported_tax_activities es unaboolean
con el valor de true si en el SII el usuario enviado tiene información reportada.
Sobre este servicio
El Servicio De Impuestos Internos (SII) es el servicio público que tiene a su cargo la aplicación y fiscalización de todos los impuestos internos de Chile. Por medio de este servicio se puede consultar la información que el SII tenga disponible para un contribuyente.
¿A quién puede consultar utilizando este servicio?:
Este servicio (sii-situacion-tributaria-cl) está disponible para consultar unicamente individuos.
Get API Access