Requerimientos API Rest SII

requerimientos-api-sii.md

API Rest SII

Crear sociedades

Endpoint:

POST /tax-accounts

Atributos en el body:

• rut RUT de la sociedad
• password Clave del SII

Respuesta 201:

{
  "data": {
    "type": "tax_accounts",
    "id": "1",
    "attributes": {
      "rut": "3097219-8"
    }
  }
}

Obtener información de impuestos mensuales

Endpoint:

GET /tax-accounts/:rut/monthly-taxes/:year/:month

Ejemplo:

GET /tax-accounts/3097219-8/monthly-taxes/2019/8

Atributos en query string:

• rut RUT de la sociedad
• year Año 2019
• month Mes 1...12

Debería enviarse con el request un header para autorizar. Quizás un token formado a partir del rut y el passoword de SII de la sociedad.

Respuesta 201:

{
  "data": {
    "type": "monthly_tax",
    "id": "1",
    "attributes": {
      "year": 2019,
      "month": 8,
      // ... todos los atributos que se extraigan que deberían deteminar con Cristian.
    }
  }
}

Preguntas/Aclaraciones:

1. Imagino que la extracicón de datos es un proceso que puede demorar algún tiempo por lo que no puede funcionar en tiempo real. Esto es: primero, usaría el enpoint para crear sociedades para darte tiempo a extraer los datos y luego, en otro momento, usaría el segundo endpoint para sacar la información mensual. Estamos de acuerdo en este punto?

2. En el endpoint para obtener la información de impuestos mensuales se me ocurrió que sería bueno preguntar por año y mes pero podría traer diréctamente toda la información de 1 año dado. Lo que sea más fácil.

3. Como puse en la definición del API, necesito que las respuestas sean JSON ojalá siguiendo el estándar de https://jsonapi.org

4. Tendremos un servidor de pruebas?

5. Cada cuánto tiempo se extraerían datos del SII?