# Enumera los estados fiscales

## ▶️ Uso

Con el método de Estado Fiscal, puedes:

1. Listar los estados fiscales relacionados con un  específico (usando el parámetro de consulta ).
2. Obtener los detalles de un  específico (usando el parámetro de consulta ).
3.  Listar todos los estados fiscales relacionados con tu cuenta de Belvo (sin usar ningún parámetro de consulta).

## 📖 Paginación

Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta  para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta  para navegar a través de los resultados. Para más detalles sobre cómo navegar por las respuestas paginadas de Belvo, consulta nuestro artículo Consejos de Paginación.

## 🔦 Filtrado de Respuestas

Consulta la lista de campos a continuación para ver los campos por los que puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrado de respuestas.

Endpoint: GET /api/cl/tax-status/
Version: 1.223.0
Security: basicAuth

## Query parameters:

  - `link` (string)
    El  por el que deseas filtrar.

ℹ️ Recomendamos encarecidamente añadir el filtro  para mejorar tu rendimiento.
    Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4"

  - `page_size` (integer)
    Indica cuántos resultados devolver por página. Por defecto, devolvemos 100 resultados por página.

ℹ️ El número mínimo de resultados devueltos por página es 1 y el máximo es 1000. Si introduces un valor mayor que 1000, nuestra API usará por defecto el valor máximo (1000).
    Example: 100

  - `page` (integer)
    Un número de página dentro del conjunto de resultados paginados.
    Example: 1

  - `omit` (string)
    Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

  - `fields` (string)
    Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas.

  - `link__in` (array)
    Devuelve resultados solo para estos s.
    Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"]

  - `id` (string)
    Devuelve información solo para este recurso .
    Example: "24ccab1d-3a86-4136-a6eb-e04bf52b356f"

  - `id__in` (array)
    Devuelve información para estos s de recursos.
    Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"]

  - `created_at` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo en esta fecha (en formato ).
    Example: "2022-05-05"

  - `created_at__gt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después de esta fecha (en formato ).
    Example: "2022-05-05"

  - `created_at__gte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después o en esta fecha (en formato ).
    Example: "2022-05-04"

  - `created_at__lt` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes de esta fecha (en formato ).
    Example: "2022-04-01"

  - `created_at__lte` (string)
    Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes o en esta fecha (en formato ).
    Example: "2022-03-30"

  - `created_at__range` (array)
    Devolver cuentas que fueron actualizadas por última vez en la base de datos de Belvo entre dos fechas (en formato ).
    Example: ["2022-03-03"]

## Response 200 fields (application/json):

  - `count` (integer)
    El número total de resultados en tu cuenta de Belvo.
    Example: 130

  - `next` (string,null)
    La URL a la siguiente página de resultados. Cada página consta de hasta 100 elementos. Si no hay suficientes resultados para una página adicional, el valor es .

En nuestro ejemplo de documentación, usamos  como un valor de marcador de posición. En producción, este valor será reemplazado por el endpoint real que estás utilizando actualmente (por ejemplo,  o ).
    Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2"

  - `previous` (string,null)
    La URL a la página anterior de resultados. Si no hay una página anterior, el valor es .

  - `results` (array)
    Matriz de objetos de estado fiscal.

  - `results.id` (string)
    Identificador único de Belvo para el elemento actual.
    Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"

  - `results.link` (string,null)
    El  al que pertenecen los datos.
    Example: "30cb4806-6e00-48a4-91c9-ca55968576c8"

  - `results.collected_at` (string)
    La marca de tiempo ISO-8601 cuando se recopiló el punto de datos.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.created_at` (string)
    La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
    Example: "2022-02-09T08:45:50.406032Z"

  - `results.entity_details` (object)
    Detalles sobre la entidad fiscal (fechas clave e información de identificación).

  - `results.entity_details.incorporation_date` (string, required)
    La fecha en que se constituyó la entidad fiscal, en formato .
    Example: "24-09-2010"

  - `results.entity_details.start_date` (string, required)
    La fecha en que la entidad fiscal comenzó a operar, en formato .
    Example: "24-09-2010"

  - `results.entity_details.end_date` (string,null, required)
    La fecha en que la entidad fiscal cesó sus operaciones, en formato . Si la entidad aún está operando, este campo devolverá .

  - `results.entity_details.document_id_type` (string, required)
    El tipo de ID de documento que tiene la entidad fiscal. Para Chile, esto será el .
    Example: "RUT"

  - `results.entity_details.document_id_number` (string, required)
    El número de identificación del documento de la entidad fiscal.
    Example: "197476427-K"

  - `results.entity_details.name` (string, required)
    El nombre de la entidad fiscal.
    Example: "Empresa de Prueba"

  - `results.addresses` (array)
    Una matriz de direcciones para la entidad fiscal.

  - `results.addresses.type` (string, required)
    El tipo de dirección. Puede ser:

  -  ()
  -  ()
  -  ()
  -  ()
    Enum: "PRIMARY", "SECONDARY", "MAILING_ADDRESS", "NOTIFICATION_ADDRESS"

  - `results.addresses.date` (string, required)
    La fecha en que la dirección fue añadida a los registros de la entidad fiscal, en formato .
    Example: "24-09-2010"

  - `results.addresses.address` (string, required)
    La dirección de la entidad fiscal.
    Example: "Calle Falsa 123"

  - `results.emails` (array)
    Una matriz de direcciones de correo electrónico para la entidad fiscal.

  - `results.emails.type` (string, required)
    El tipo de correo electrónico. Puede ser:

-  ()
-  ()
- .
    Enum: "CONTACT", "NOTIFICATION", "OTHER"

  - `results.emails.email` (string, required)
    La dirección de correo electrónico de la entidad fiscal.
    Example: "mi-email@empresa.cl"

  - `results.phone_numbers` (array)
    Un array de números de teléfono para la entidad fiscal.

  - `results.phone_numbers.type` (string,null, required)
    El tipo de número de teléfono. Puede ser:

  - 
  - 
  -
    Enum: "LANDLINE", "MOBILE", "OTHER", "null"

  - `results.phone_numbers.number` (string, required)
    El número de teléfono de la entidad fiscal.
    Example: 123456789

  - `results.economic_activities` (array)
    Un conjunto de actividades económicas para la entidad fiscal.

  - `results.economic_activities.type` (string, required)
    El tipo de actividad económica general, según el Servicio de Impuestos Internos (SII).
    Example: "ASESORIA EN INGENIERIA"

  - `results.economic_activities.activity` (string, required)
    La actividad económica específica, según el Servicio de Impuestos Internos (SII).
    Example: "ACTIVIDADES DE CONSULTORIA DE GESTION"

  - `results.economic_activities.code` (string, required)
    El código de actividad económica, según el Servicio de Impuestos Internos (SII).
    Example: "702000"

  - `results.economic_activities.tax_category` (integer, required)
    La categoría tributaria de la actividad económica, según el Servicio de Impuestos Internos (SII).
    Example: 1

  - `results.economic_activities.vat_affected` (boolean, required)
    Indica si la actividad económica está afectada por el IVA.
    Example: true

  - `results.economic_activities.start_date` (string, required)
    La fecha en que la entidad fiscal comenzó esta actividad económica, en formato .
    Example: "24-09-2010"

  - `results.legal_representative` (array)
    Un array de representantes legales para la entidad fiscal.

  - `results.legal_representative.is_current` (boolean, required)
    Indica si el representante legal es el representante legal actual de la entidad fiscal.
    Example: true

  - `results.legal_representative.name` (string, required)
    El nombre del representante legal.
    Example: "Juan Perez"

  - `results.legal_representative.document_id_type` (string, required)
    El tipo de identificación del documento del representante legal. Para Chile, esto siempre se establecerá como .
    Enum: "RUT"

  - `results.legal_representative.document_id_number` (string, required)
    El número de identificación del documento del representante legal. Para Chile, este será el número RUT.
    Example: "12345678-9"

  - `results.legal_representative.start_date` (string, required)
    La fecha en que el representante legal comenzó a representar a la entidad fiscal, en formato .
    Example: "24-09-2010"

  - `results.legal_representative.end_date` (string,null)
    La fecha en que el representante legal dejó de representar a la entidad fiscal, en formato . Si el representante legal aún representa a la entidad fiscal, este campo devolverá .

  - `results.equity_holders` (array)
    Un array de titulares de acciones para la entidad fiscal.

  - `results.equity_holders.is_current` (boolean, required)
    Indica si el titular de la equidad está actualmente activo.
    Example: true

  - `results.equity_holders.name` (string, required)
    El nombre del titular de la participación.
    Example: "Juan Perez"

  - `results.equity_holders.document_id_type` (string, required)
    El tipo de identificación del documento del titular de la equidad. Para Chile, esto siempre se establecerá en .
    Enum: "RUT"

  - `results.equity_holders.document_id_number` (string, required)
    El número de identificación del documento del titular de acciones. Para Chile, este será el número RUT.
    Example: "12345678-9"

  - `results.equity_holders.inactive` (boolean, required)
    Indica si el titular de la equidad está actualmente inactivo.

  - `results.equity_holders.start_date` (string, required)
    La fecha en que el titular de la equidad comenzó a poseer equidad en la entidad fiscal, en formato .
    Example: "24-09-2010"

  - `results.equity_holders.end_date` (string,null)
    La fecha en que el titular de la participación dejó de tener participación en la entidad fiscal, en formato . Si el titular de la participación aún mantiene participación en la entidad fiscal, este campo devolverá .

  - `results.equity_holders.capital_contributed` (number, required)
    La cantidad de capital aportada por el titular de capital.
    Example: 1000000

  - `results.equity_holders.capital_contribution_outstanding` (number, required)
    El monto de la contribución de capital pendiente por parte del titular de capital.
    Example: 3750

  - `results.equity_holders.ownership_share` (number, required)
    El porcentaje de participación accionaria del titular de capital.
    Example: 25.25

  - `results.equity_holders.profit_share` (number, required)
    El porcentaje de participación en las ganancias del titular de acciones.
    Example: 31.25

  - `results.company_partnership_stakes` (array)
    Una matriz de participaciones en asociaciones de la empresa para la entidad fiscal.

  - `results.company_partnership_stakes.name` (string, required)
    El nombre de la entidad que esta entidad fiscal.
    Example: "Empresa de Prueba"

  - `results.company_partnership_stakes.document_id_type` (string, required)
    El tipo de ID de documento del negocio. Para Chile, esto siempre se establecerá en .
    Enum: "RUT"

  - `results.company_partnership_stakes.document_id_number` (string, required)
    El número de identificación del documento de la empresa. Para Chile, este será el número RUT.
    Example: "12345678-9"

  - `results.company_partnership_stakes.inactive` (boolean, required)
    Indica si el negocio está actualmente activo.

  - `results.company_partnership_stakes.start_date` (string, required)
    La fecha en que la empresa comenzó a tener participación en la entidad fiscal, en formato .
    Example: "24-09-2010"

  - `results.company_partnership_stakes.end_date` (string,null)
    La fecha en que el titular de la empresa dejó de poseer acciones en la entidad fiscal, en formato . Si el titular de las acciones aún posee acciones en la entidad fiscal, este campo devolverá .

  - `results.company_partnership_stakes.capital_contributed` (number, required)
    La cantidad de capital aportado por la empresa.
    Example: 1000000.02

  - `results.company_partnership_stakes.capital_contribution_outstanding` (number, required)
    El monto de la contribución de capital pendiente por la empresa.
    Example: 3750.02

  - `results.company_partnership_stakes.ownership_share` (number, required)
    El porcentaje de participación accionaria de la empresa.
    Example: 25.25

  - `results.company_partnership_stakes.profit_share` (number, required)
    El porcentaje de participación en las ganancias de la empresa.
    Example: 31.25

  - `results.regimes` (array,null)
    Una lista de regímenes fiscales para la entidad fiscal.

  - `results.regimes.type` (string, required)
    El tipo de régimen tributario, según lo definido por el Servicio de Impuestos Internos (SII).
    Example: "MICRO EMPRESA"

  - `results.regimes.start_date` (string, required)
    La fecha en que la entidad fiscal comenzó este régimen fiscal, en formato .
    Example: "2023-01-01"

  - `results.authorized_tax_documents` (array,null)
    Una lista de documentos fiscales autorizados para la entidad fiscal.

  - `results.authorized_tax_documents.type` (string, required)
    El tipo de documento tributario autorizado, según lo definido por el Servicio de Impuestos Internos (SII).
    Example: "CONTABILIDAD EN HOJAS SUELTAS CON NRO.UN"

  - `results.authorized_tax_documents.document_limit` (integer, required)
    El número máximo de documentos que se pueden emitir bajo esta autorización.
    Example: 2000

  - `results.authorized_tax_documents.authorization_date` (string, required)
    La fecha en que se establecieron el documento fiscal y el límite, en formato .
    Example: "2010-18-11"

  - `results.property_tax_liabilities` (array,null)
    Una lista de las obligaciones fiscales de una propiedad con las que la entidad está asociada.

  - `results.property_tax_liabilities.property_id` (string, required)
    El identificador único de la propiedad, según el Servicio de Impuestos Internos (SII).
    Example: "12345"

  - `results.property_tax_liabilities.district` (string, required)
    El distrito donde se encuentra la propiedad.
    Example: "NUNAO"

  - `results.property_tax_liabilities.address` (string, required)
    La dirección de la propiedad.
    Example: "123 Example Street"

  - `results.property_tax_liabilities.type` (string, required)
    El tipo de propiedad asociado con la responsabilidad fiscal.
    Example: "HABITACIONAL"

  - `results.property_tax_liabilities.overdue_tax_payments` (array, required)
    Una lista de pagos de impuestos atrasados para la propiedad.

  - `results.property_tax_liabilities.overdue_tax_payments.year` (integer, required)
    El año para el cual el pago de impuestos está atrasado.
    Example: 2023

  - `results.property_tax_liabilities.overdue_tax_payments.installment` (integer, required)
    El número de cuota del pago de impuestos atrasado.
    Example: 1

  - `results.property_tax_liabilities.overdue_tax_payments.due_date` (string, required)
    La fecha de vencimiento del pago de impuestos atrasados, en formato .
    Example: "2023-04-30"

  - `results.property_tax_liabilities.overdue_tax_payments.amount_due` (number, required)
    El monto adeudado por el pago de impuestos atrasado.
    Example: 19.864

  - `results.property_tax_liabilities.scheduled_tax_payments` (array, required)
    Una lista de pagos de impuestos programados para la propiedad.

  - `results.property_tax_liabilities.scheduled_tax_payments.year` (integer, required)
    El año para el cual está programado el pago de impuestos.
    Example: 2023

  - `results.property_tax_liabilities.scheduled_tax_payments.installment` (integer, required)
    El número de cuota del pago de impuestos programado.
    Example: 1

  - `results.property_tax_liabilities.scheduled_tax_payments.due_date` (string, required)
    La fecha de vencimiento del pago de impuestos programado, en formato .
    Example: "2023-04-30"

  - `results.property_tax_liabilities.scheduled_tax_payments.amount_due` (number, required)
    El monto adeudado para el pago programado de impuestos.
    Example: 19.864

  - `results.fiscal_office` (object)
    Detalles sobre la oficina fiscal donde está registrada la entidad fiscal.

  - `results.fiscal_office.name` (string, required)
    El nombre de la oficina fiscal donde está registrado el ente fiscal.
    Example: "VIÑA DEL MAR"

  - `results.fiscal_office.address` (string, required)
    La dirección de la oficina fiscal donde está registrado el ente fiscal.
    Example: "ARLEGUI 525, VIÑA DEL MAR"

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Una breve descripción del error.

Para los errores , la descripción es:

  - .
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.
    Example: "not_found"

  - `message` (string)
    Una breve descripción del error.

Para errores , la descripción es:

  -
    Example: "Not found"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Una breve descripción del error.

Para los errores de , la descripción es:

  - .
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único () que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Una breve descripción del error.

Para los errores , la descripción es:

- .
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"