Bienvenido a la documentación de Fapro. Aquí encontrarás todo lo necesario para integrarte con nuestra API: guías paso a paso, referencias técnicas y ejemplos prácticos. Si necesitas ayuda, nuestro equipo de soporte está disponible.
\nTodas las solicitudes deben hacerse sobre el siguiente host:
\nhttps://api.fapro.app
Descripción: Autentica a un usuario registrado en el sistema mediante sus credenciales. Si la autenticación es exitosa, retorna un token de acceso (JWT u otro formato) que debe incluirse en las solicitudes posteriores para acceder a recursos protegidos.
\nMétodo: POST
\nURL: https://api.fapro.app/api/v1.0/login
\nAuthorization: Bearer {{jwt}}
\n{
\n\"email\": \"usuario@test.com\",
\n\"password\": \"contraseña secreta\"
}
{\n \"status\": \"success\",\n \"code\": 200,\n \"data\": {\n \"accessToken\": \"XXXXXXXXXXXXxxxxxxxxxxxXXXXXXXXXXX\",\n \"token\": {\n \"id\": \"XXXXXXXXXXXXxxxxxxxxxxxXXXXXXXXXXX\",\n \"user_id\": 0001,\n \"client_id\": \"0\",\n \"name\": \"\",\n \"scopes\": [],\n \"revoked\": false,\n \"created_at\": \"2026-04-15 18:50:09.054\",\n \"updated_at\": \"2026-04-15 18:50:09.054\",\n \"expires_at\": \"2026-04-16T03:50:09.054Z\"\n },\n \"country\": \"pais\"\n },\n \"message\": \"Authenticación correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código HTTP de la respuesta (integer).
\ndata: Objeto principal con los datos de sesión del usuario (object).
\naccessToken: Token de acceso que debe enviarse en el header Authorization de las requests (string).
\ntoken: Información detallada del token generado (object).
\nid: Identificador único del token (string).
\nuser_id: ID del usuario al que pertenece el token (integer).
\nclient_id: ID del cliente OAuth asociado a la sesión (string).
\nname: Nombre descriptivo del token (puede estar vacío) (string).
\nscopes: Lista de permisos/alcances otorgados al token (array).
\nrevoked: Indica si el token fue revocado. false = token activo (boolean).
\ncreated_at: Fecha y hora de creación del token (string datetime).
\nupdated_at: Fecha y hora de última actualización del token (string datetime).
\nexpires_at: Fecha y hora de expiración del token (string datetime).
\ncountry: País asociado al usuario autenticado (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 422,\n \"message\": \"email and password are required\"\n}\n\n401 Unauthorized
\n{\n \"status\": \"error\",\n \"code\": 401,\n \"message\": \"Invalid credentials\"\n}\n\nDescripción: Esta API permite agregar empresas con su contraseña del Servicio de Impuestos Internos.
\nMétodo: POST
\nURL: https://api.fapro.app/api/v1.0/company/create_from_password
\nAuthorization: Bearer {{jwt}}
\n{
\n\"email\": \"usuario@test.com\",
\n\"password\": \"contraseña secreta\"
\n\"rz\": \"nombre empresa\"
}
{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"id\": 0001,\n \"business_name\": \"nombre empresa\",\n \"rut\": \"12345678-9\"\n },\n \"message\": \"Empresa creada correctamente\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto con los datos de la empresa creada (object).
\nid: Identificador único de la empresa generado por el sistema (integer).
\nbusiness_name: Nombre o razón social de la empresa (string).
\nrut: RUT de la empresa (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n- 400 Bad Request: cuando la clave tributaria del SII es incorrecta
\n- 422 Unprocessable Entity: cuando faltan campos obligatorios
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"la Clave Tributaria ingresada no es correcta\",\n \"errors\": []\n}\n\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El campo password es obligatorio.\",\n \"errors\": [\n \"El campo password es obligatorio.\"\n ]\n}\n\nDescripción: Esta API permite agregar empresas con su certificado digital del Servicio de Impuestos Internos.
\nMétodo: POST
\nURL: https://api.fapro.app/api/v1.0/company/create_from_certificate
\nAuthorization: Bearer {{jwt}}
\n{
\n\"rz\": \"\",
\n\"rut\": \"rut empresa\",
\n\"password\": \"clave de la empresa\",
\n\"name\": \"\",
\n\"factoring\":\"\",
\n\"certificate\": \"certificado digital\"
}
{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"id\": 1010,\n \"business_name\": \"Nombre empresa\",\n \"rut\": \"98765432-1\"\n },\n \"message\": \"Empresa Actualizada correctamente\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto con los datos de la empresa creada (object).
\nid: Identificador único de la empresa generado por el sistema (integer).
\nbusiness_name: Nombre o razón social de la empresa (string).
\nrut: RUT de la empresa (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n- 400 Bad Request: cuando la clave tributaria del SII es incorrecta
\n- 422 Unprocessable Entity: cuando faltan campos obligatorios
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"La contraseña del certificado es incorrecta\",\n \"errors\": []\n}\n\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut es obligatorio.\",\n \"errors\": [\n \"El rut es obligatorio.\",\n \"La contraseña es obligatoria.\",\n \"El certificado digital es obligatorio\"\n ]\n}\n\nDeshabilita una o varias empresas en el sistema. Este endpoint permite inhabilitar una empresa de forma individual mediante su RUT, o en lote proporcionando una lista de RUTs.
\nPOST https://api.fapro.app/api/v1.0/company/disable\n\nEste endpoint requiere autenticación mediante Bearer Token. El token JWT debe enviarse en el header Authorization.
{\n \"rut\": \"12345678-9\"\n}\n\n{\n \"ruts\": [\"12345678-9\", \"98765432-1\"]\n}\n\nDescripción: Esta API permite consultar el detalle completo de una empresa registrada en el sistema a través de su RUT. La respuesta incluye datos generales como razón social, correo de sucursal y ejecutivo asignado, estado de conexión, origen de vinculación, disponibilidad de carpeta tributaria y fechas relevantes como creación del registro, inicio de actividades y última actualización del token.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/profile
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"company\": {\n \"authentication\": \"\",\n \"branch\": \"user@test.com\",\n \"business_name\": \"nombre empresa\",\n \"connected\": 0,\n \"created_at\": \"2023-07-10 14:38:00\",\n \"disable_date\": null,\n \"es_mipyme\": \"1\",\n \"executive\": \"ejecutivo@test.com\",\n \"group\": null,\n \"has_taxfolder\": false,\n \"is_company_in_a_day\": \"0\",\n \"origen_vinculacion\": \"Indeterminado\",\n \"rut\": \"12345678-9\",\n \"start_activities_date\": null,\n \"token_date\": \"2023-07-11 14:17:37.297\"\n }\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la empresa (object).
\ncompany: Objeto con el detalle de la empresa (object).
\nauthentication: Datos de autenticación de la empresa (string).
\nbranch: Correo electrónico de la sucursal o usuario asociado (string).
\nbusiness_name: Nombre o razón social de la empresa (string).
\nconnected: Estado de conexión de la empresa. 0 = desconectado (integer).
\ncreated_at: Fecha y hora de creación del registro (string datetime).
\ndisable_date: Fecha en que la empresa fue deshabilitada. Null si está activa (null o string).
\nes_mipyme: Indica si la empresa es MIPYME. \"1\" = sí, \"0\" = no (string).
\nexecutive: Correo electrónico del ejecutivo asignado (string).
\ngroup: Grupo al que pertenece la empresa. Null si no tiene grupo asignado (null o string).
\nhas_taxfolder: Indica si la empresa tiene carpeta tributaria (boolean).
\nis_company_in_a_day: Indica si la empresa fue creada en un día. \"1\" = sí, \"0\" = no (string).
\norigen_vinculacion: Origen de la vinculación de la empresa (string).
\nrut: RUT de la empresa (string).
\nstart_activities_date: Fecha de inicio de actividades. Null si no está registrada (null o string).
\ntoken_date: Fecha y hora del último token generado para la empresa (string datetime).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API entrega el listado de los mayores clientes de la empresa consultada. Retorna la Razón Social, RUT y monto bruto vendido en un rango de fechas.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/main_customers
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"customer\": [\n {\n \"Razon Social\": \"Nombre empresa \",\n \"RUT\": \"12345678\",\n \"dv_RUT\": \"9\",\n \"Monto_total_vendido\": \"1417221829\"\n },\n {\n \"Razon Social\": \"Nombre empresa \",\n \"RUT\": \"12345678\",\n \"dv_RUT\": \"9\",\n \"Monto_total_vendido\": \"1411829\"\n },\n {\n \"Razon Social\": \"Nombre empresa \",\n \"RUT\": \"12345678\",\n \"dv_RUT\": \"9\",\n \"Monto_total_vendido\": \"1417221829\"\n },\n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ncustomer: Listado de los mayores clientes de la empresa consultada (array of objects).
\nRazon Social: Nombre o razón social del cliente (string).
\nRUT: RUT del cliente sin dígito verificador (string).
\ndv_RUT: Dígito verificador del RUT del cliente (string).
\nMonto_total_vendido: Monto bruto total vendido al cliente en el rango de fechas consultado (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API te entregará el listado de los mayores proveedores de la empresa consultada, obtendrás Razón Social, RUT y monto bruto vendido en un rango de fechas.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/main_suppliers
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"supplier\": [\n {\n \"Razon Social\": \"Nombre de empresa 1\",\n \"RUT\": \"12345678\",\n \"dv_RUT\": \"K\",\n \"Monto total comprado\": \"287635201\"\n },\n {\n \"Razon Social\": \"Nombre de empresa 2\",\n \"RUT\": \"12345678\",\n \"dv_RUT\": \"K\",\n \"Monto total comprado\": \"9876666\"\n },\n {\n \"Razon Social\": \"Nombre de empresa 3 \",\n \"RUT\": \"12345678\",\n \"dv_RUT\": \"K\",\n \"Monto total comprado\": \"878787655\"\n },\n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\nsupplier: Listado de los mayores proveedores de la empresa consultada (array of objects).
\nRazon Social: Nombre o razón social del proveedor (string).
\nRUT: RUT del proveedor sin dígito verificador (string).
\ndv_RUT: Dígito verificador del RUT del proveedor (string).
\nMonto total comprado: Monto bruto total comprado al proveedor en el rango de fechas consultado (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El campo fecha inicial es obligatorio.\",\n \"errors\": [\n \"El campo fecha inicial es obligatorio.\"\n ]\n}\n\nDescripción: Esta API permite consultar los representantes declarados en el SII.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/representante
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"representantes\": [\n {\n \"rut_representante\": \"12345678\",\n \"dv_representante\": \"9\",\n \"razon_social\": \"Nombre de la empresa\",\n \"nombres_representante\": \"Nombre del representante\",\n \"apellido_paterno_representante\": \"Apellido paterno del representante\",\n \"apellido_materno_representante\": \"Apellido materno del representante\",\n \"fecha_incorporacion_representante\": \"2019-11-21\",\n \"fecha_termino_representante\": null,\n \"vigente\": \"1\"\n }\n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\nrepresentantes: Listado de representantes legales de la empresa (array of objects).
\nrut_representante: RUT del representante legal sin dígito verificador (string).
\ndv_representante: Dígito verificador del RUT del representante legal (string).
\nrazon_social: Nombre o razón social de la empresa asociada al representante (string).
\nnombres_representante: Nombres del representante legal (string).
\napellido_paterno_representante: Apellido paterno del representante legal (string).
\napellido_materno_representante: Apellido materno del representante legal (string).
\nfecha_incorporacion_representante: Fecha en que el representante fue incorporado (string date).
\nfecha_termino_representante: Fecha en que finalizó la representación. Null si sigue vigente (null o string date).
\nvigente: Indica si el representante está activo. \"1\" = vigente, \"0\" = no vigente (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"La empresa no existe\",\n \"errors\": []\n}\n\nDescripción: Esta API permite consultar los socios declarados en el SII.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/socios
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"Socios\": [\n {\n \"rut_socio\": \"12345678\",\n \"dv_socio\": \"5\",\n \"razon_social\": \"Nombre empresa\",\n \"nombres_socio\": \"Nombres socio\",\n \"company_id\": \"001\",\n \"apellido_paterno_socio\": \"Apeliido paterno socio\",\n \"apellido_materno_socio\": \"Apeliido materno socio\",\n \"porcentaje_utilidad\": \"100.000\",\n \"fecha_incorporacion_socio\": \"2019-11-21\",\n \"fecha_termino_socio\": null,\n \"capital_enterado\": \"1000\",\n \"capital_por_enterar\": \"\",\n \"capital_total\": null,\n \"capital_fecha_enterar\": null,\n \"capital_reserva\": null,\n \"capital_porcentaje_utilidad_total\": null,\n \"porcentaje_capital\": null,\n \"vigente\": \"1\"\n }\n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\nSocios: Listado de socios de la empresa (array of objects).
\nrut_socio: RUT del socio sin dígito verificador (string).
\ndv_socio: Dígito verificador del RUT del socio (string).
\nrazon_social: Nombre o razón social de la empresa asociada al socio (string).
\nnombres_socio: Nombres del socio (string).
\ncompany_id: Identificador único de la empresa (string).
\napellido_paterno_socio: Apellido paterno del socio (string).
\napellido_materno_socio: Apellido materno del socio (string).
\nporcentaje_utilidad: Porcentaje de utilidad asignado al socio (string).
\nfecha_incorporacion_socio: Fecha en que el socio fue incorporado a la empresa (string date).
\nfecha_termino_socio: Fecha en que finalizó la participación del socio. Null si sigue vigente (null o string date).
\ncapital_enterado: Monto de capital ya aportado por el socio (string).
\ncapital_por_enterar: Monto de capital pendiente de aportar por el socio (string).
\ncapital_total: Monto total de capital del socio. Null si no está registrado (null o string).
\ncapital_fecha_enterar: Fecha límite para enterar el capital pendiente. Null si no aplica (null o string date).
\ncapital_reserva: Monto de capital en reserva. Null si no aplica (null o string).
\ncapital_porcentaje_utilidad_total: Porcentaje total de utilidad sobre el capital. Null si no aplica (null o string).
\nporcentaje_capital: Porcentaje de capital del socio sobre el total de la empresa. Null si no aplica (null o string).
\nvigente: Indica si el socio está activo. \"1\" = vigente, \"0\" = no vigente (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"La empresa no existe\",\n \"errors\": []\n}\n\nDescripción: Esta API permite consultar el resumen consolidado por mes cerrado de una empresa, retornando información agrupada por tipo de operación (compra o venta) y periodo mensual. Para cada registro entrega el monto neto, monto exento y el total neto, permitiendo realizar un análisis financiero consolidado de las operaciones de la empresa en un rango de fechas determinado.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/consolidated_summaries_month_closed
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"data\": [\n {\n \"rut\": \"1234568-7\",\n \"company_id\": \"001\",\n \"operacion\": \"COMPRA\",\n \"periodo\": \"202305\",\n \"monto_neto\": \"4451789\",\n \"monto_exento\": \"572629\",\n \"total_neto\": \"5024418\"\n },\n {\n \"rut\": \"98765432-7\",\n \"company_id\": \"966\",\n \"operacion\": \"VENTA\",\n \"periodo\": \"202304\",\n \"monto_neto\": \"10111075\",\n \"monto_exento\": \"0\",\n \"total_neto\": \"10111075\"\n }, \n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata: Listado del resumen consolidado por mes cerrado de la empresa (array of objects).
\nrut: RUT de la empresa con dígito verificador (string).
\ncompany_id: Identificador único de la empresa (string).
\noperacion: Tipo de operación registrada. Valores posibles: \"COMPRA\" o \"VENTA\" (string).
\nperiodo: Periodo correspondiente al mes cerrado en formato YYYYMM (string).
\nmonto_neto: Monto neto de las operaciones del periodo (string).
\nmonto_exento: Monto exento de impuestos del periodo (string).
\ntotal_neto: Suma total entre monto neto y monto exento del periodo (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El campo rut es obligatorio.\",\n \"errors\": [\n \"El campo rut es obligatorio.\"\n ]\n}\n\nDescripción: Esta API permite obtener el % de notas de créditos sobre los documentos cedidos en un periodo de tiempo determinado, es posible consultar la empresa en general o la empresa por un cliente particular.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/percentage_nc_total_ceded
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"consolidado\": 0,\n \"deudores\": [\n {\n \"rut_deudor\": \"98765432\",\n \"porcentaje_nc_sobre_total_cedido\": 0\n }\n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.consolidado: Porcentaje consolidado de notas de crédito sobre el total cedido, considerando a todos los deudores en conjunto (integer/decimal).
\ndata.deudores: Listado de deudores con el detalle individual del indicador (array).
\ndata.deudores[].rut_deudor: RUT del deudor asociado a las facturas cedidas (string).
\ndata.deudores[].porcentaje_nc_sobre_total_cedido: Porcentaje que representan las notas de crédito emitidas sobre el total cedido para ese deudor específico (integer/decimal).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"El campo fecha inicial es obligatorio.\",\n \"El campo fecha final es obligatorio.\"\n ]\n}\n\nDescripción: Esta API permite obtener el % de notas de créditos sobre las ventas en un periodo de tiempo determinado, es posible consultar la empresa en general o la empresa por un cliente particular.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/percentage_nc_total_sold
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"porcentaje_nota_credito_sobre_ventas_totales\": 0\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
· porcentaje_nota_credito_sobre_ventas_totales: Porcentaje que representan las notas de crédito sobre el total de ventas de la empresa en el periodo consultado (float).
message: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API permite obtener el % de facturas reclamadas sobre las ventas en un periodo de tiempo determinado, es posible consultar la empresa en general o la empresa por un cliente particular.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/percentage_claimed_invoices_sale
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"%_factura_reclamada_sobre_venta\": 0\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
· %_factura_reclamada_sobre_venta: Porcentaje que representan las facturas reclamadas sobre el total de ventas de la empresa en el periodo consultado (float).
message: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Devuelve el indicador de share of wallet de un cliente, es decir, la porción del total factorizado por ese cliente en el mercado que corresponde a operaciones realizadas con nuestra empresa.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/share-of-wallet
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"share of wallet\": \"0.0000\"\n },\n \"message\": \"Ejecución correcta\"\n}\n\nNota: El parámetro rut es opcional. Si se especifica, la respuesta incluirá únicamente la información asociada a ese RUT. Si se omite, el endpoint retornará el listado completo de RUTs registrados en el sistema.
status: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.share of wallet: Porcentaje de participación de la empresa sobre el total factorizado por el cliente en el mercado (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El campo fecha inicial es obligatorio.\",\n \"errors\": [\n \"El campo fecha inicial es obligatorio.\",\n \"El campo fecha final es obligatorio.\"\n ]\n}\n\nDescripción: Esta API entrega las compras mensuales de un RUT específico en un intervalo de tiempo determinado.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/total-purchase
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"total_purchases\": \"0\"\n },\n \"message\": \"Ejecucion correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
· total_purchases: Monto total de compras de la empresa en el periodo consultado (string).
message: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API entrega las ventas mensuales de un RUT específico en un intervalo de tiempo determinado.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/total-sale
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"total_sales\": \"0\"\n },\n \"message\": \"Ejecucion correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
· total_sales: Monto total de ventas de la empresa en el periodo consultado (string).
message: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API entrega las compras, ventas y margen mensuales de un RUT específico en un intervalo de tiempo determinado. El formato de la fecha es AAAA-MM-DD.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/total-consolidated
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"total_purchases\": \"0\",\n \"total_sales\": \"0\",\n \"total_gross_profit\": 0\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
· total_purchases: Monto total de compras de la empresa en el periodo consultado (string).
· total_sales: Monto total de ventas de la empresa en el periodo consultado (string).
· total_gross_profit: Utilidad bruta total de la empresa en el periodo consultado (float).
message: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API entrega la lista de documentos ventas de un RUT específico en un intervalo de tiempo determinado.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.2/company/list-docs-sales
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"facturas_ventas\": [\n {\n \"folio\": \"3001\",\n \"fecha_documento\": \"2026-04-01\",\n \"fecha_recepcion_sii\": \"2026-04-07\",\n \"tipo_documento\": \"33\",\n \"rut_emisor\": \"98765432\",\n \"dv_emisor\": \"8\",\n \"rut_deudor\": \"712345678\",\n \"dv_deudor\": \"0\",\n \"razon_social_deudor\": \"Nombre empresa deudor\",\n \"monto_total_factura\": \"85341\",\n \"fecha_de_reclamo\": null,\n \"evento_receptor\": \"\",\n \"estado_cesion\": \"0\",\n \"rut_cesionario\": null,\n \"dv_cesionario\": null,\n \"rz_cesionario\": null,\n \"fecha_cesion\": null,\n \"notas_debito_asociadas\": [],\n \"notas_credito_asociadas\": [\n {\n \"folio\": 91,\n \"monto_total_nota_credito\": 23118028\n }\n ]\n }\n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.facturas_ventas: Listado de facturas de venta registradas (array).
\ndata.facturas_ventas[].folio: Número de folio del documento tributario electrónico (string).
\ndata.facturas_ventas[].fecha_documento: Fecha de emisión del documento, en formato AAAA-MM-DD (string).
data.facturas_ventas[].fecha_recepcion_sii: Fecha en que el documento fue recepcionado por el Servicio de Impuestos Internos (SII), en formato AAAA-MM-DD (string).
data.facturas_ventas[].tipo_documento: Código SII del tipo de Documento Tributario Electrónico. Ejemplo: \"33\" corresponde a Factura Electrónica (string).
data.facturas_ventas[].rut_emisor: RUT de la empresa emisora del documento, sin dígito verificador (string).
\ndata.facturas_ventas[].dv_emisor: Dígito verificador del RUT del emisor (string).
\ndata.facturas_ventas[].rut_deudor: RUT del deudor o receptor del documento, sin dígito verificador (string).
\ndata.facturas_ventas[].dv_deudor: Dígito verificador del RUT del deudor (string).
\ndata.facturas_ventas[].razon_social_deudor: Razón social de la empresa deudora del documento (string).
\ndata.facturas_ventas[].monto_total_factura: Monto total de la factura, expresado en pesos chilenos (string).
\ndata.facturas_ventas[].fecha_de_reclamo: Fecha en la que el documento fue reclamado ante el SII. null si no existe reclamo (string | null).
data.facturas_ventas[].evento_receptor: Descripción del evento o estado registrado por el receptor del documento. Cadena vacía si no hay evento registrado (string).
\ndata.facturas_ventas[].estado_cesion: Estado de cesión de la factura ante el SII. Ejemplo: \"0\" indica que no ha sido cedida (string).
data.facturas_ventas[].rut_cesionario: RUT de la empresa cesionaria a la que se cedió la factura, sin dígito verificador. null si no ha sido cedida (string | null).
data.facturas_ventas[].dv_cesionario: Dígito verificador del RUT del cesionario. null si no ha sido cedida (string | null).
data.facturas_ventas[].rz_cesionario: Razón social del cesionario. null si no ha sido cedida (string | null).
data.facturas_ventas[].fecha_cesion: Fecha en la que se realizó la cesión de la factura. null si no ha sido cedida (string | null).
data.facturas_ventas[].notas_debito_asociadas: Listado de notas de débito asociadas al documento (array).
\ndata.facturas_ventas[].notas_credito_asociadas: Listado de notas de crédito asociadas al documento (array).
\ndata.facturas_ventas[].notas_credito_asociadas[].folio: Número de folio de la nota de crédito asociada (integer).
\ndata.facturas_ventas[].notas_credito_asociadas[].monto_total_nota_credito: Monto total de la nota de crédito, expresado en pesos chilenos (integer).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El campo rut_emisor es obligatorio.\",\n \"errors\": [\n \"El campo rut_emisor es obligatorio.\",\n \"El campo fecha_inicial es obligatorio.\",\n \"El campo fecha_final es obligatorio.\"\n ]\n}\n\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API permite obtener el listado de facturas de compra emitidas a la empresa consultada durante un periodo específico. El filtro de fechas se aplica sobre la fecha en que el SII recepcionó cada documento, no sobre la fecha de emisión
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.2/company/list_docs_purchases
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"facturas_compras\": [\n {\n \"folio\": \"6551\",\n \"fecha_documento\": \"2026-01-26\",\n \"fecha_recepcion_sii\": \"2026-01-26\",\n \"tipo_documento\": \"33\",\n \"rut_emisor\": \"98765432\",\n \"dv_emisor\": \"1\",\n \"rut_deudor\": \"12345678\",\n \"dv_deudor\": \"7\",\n \"razon_social_emisor\": \"Nombre empresa emisora\",\n \"monto_total_factura\": \"373692\",\n \"fecha_de_reclamo\": null,\n \"evento_receptor\": \"Forma de pago contado\",\n \"estado_cesion\": \"0\",\n \"rut_cesionario\": null,\n \"dv_cesionario\": null,\n \"rz_cesionario\": null,\n \"fecha_cesion\": null,\n \"notas_debito_asociadas\": [],\n \"notas_credito_asociadas\": []\n }\n ]\n }\n \"message\": \"Ejecución correcta\"\n}\n\nAcá tenés la descripción:Descripción de la Respuesta
\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.facturas_compras: Listado de facturas de compra registradas (array).
\ndata.facturas_compras[].folio: Número de folio del documento tributario electrónico (string).
\ndata.facturas_compras[].fecha_documento: Fecha de emisión del documento, en formato AAAA-MM-DD (string).
data.facturas_compras[].fecha_recepcion_sii: Fecha en que el documento fue recepcionado por el Servicio de Impuestos Internos (SII), en formato AAAA-MM-DD (string).
data.facturas_compras[].tipo_documento: Código SII del tipo de Documento Tributario Electrónico. Ejemplo: \"33\" corresponde a Factura Electrónica (string).
data.facturas_compras[].rut_emisor: RUT de la empresa emisora del documento, sin dígito verificador (string).
\ndata.facturas_compras[].dv_emisor: Dígito verificador del RUT del emisor (string).
\ndata.facturas_compras[].rut_deudor: RUT del deudor o receptor del documento, sin dígito verificador (string).
\ndata.facturas_compras[].dv_deudor: Dígito verificador del RUT del deudor (string).
\ndata.facturas_compras[].razon_social_emisor: Razón social de la empresa emisora del documento (string).
\ndata.facturas_compras[].monto_total_factura: Monto total de la factura, expresado en pesos chilenos (string).
\ndata.facturas_compras[].fecha_de_reclamo: Fecha en la que el documento fue reclamado ante el SII. null si no existe reclamo (string | null).
data.facturas_compras[].evento_receptor: Descripción del evento o estado registrado por el receptor del documento. Ejemplo: \"Forma de pago contado\" (string).
data.facturas_compras[].estado_cesion: Estado de cesión de la factura ante el SII. Ejemplo: \"0\" indica que no ha sido cedida (string).
data.facturas_compras[].rut_cesionario: RUT de la empresa cesionaria a la que se cedió la factura, sin dígito verificador. null si no ha sido cedida (string | null).
data.facturas_compras[].dv_cesionario: Dígito verificador del RUT del cesionario. null si no ha sido cedida (string | null).
data.facturas_compras[].rz_cesionario: Razón social del cesionario. null si no ha sido cedida (string | null).
data.facturas_compras[].fecha_cesion: Fecha en la que se realizó la cesión de la factura. null si no ha sido cedida (string | null).
data.facturas_compras[].notas_debito_asociadas: Listado de notas de débito asociadas al documento (array).
\ndata.facturas_compras[].notas_credito_asociadas: Listado de notas de crédito asociadas al documento (array).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El campo rut es obligatorio.\",\n \"errors\": [\n \"El campo rut es obligatorio.\",\n \"El campo fecha inicial es obligatorio.\",\n \"El campo fecha final es obligatorio.\"\n ]\n}\n\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nint
\n","type":"text/plain"},"key":"folio","value":""},{"disabled":true,"description":{"content":"int
\n","type":"text/plain"},"key":"tipo_documento","value":""},{"disabled":true,"description":{"content":"boolean
\n","type":"text/plain"},"key":"facturas_cedidas","value":""},{"disabled":true,"description":{"content":"boolean
\n","type":"text/plain"},"key":"facturas_nota_credito","value":""},{"disabled":true,"description":{"content":"boolean
\n","type":"text/plain"},"key":"facturas_rechazadas","value":""}],"variable":[]}},"response":[{"id":"6d178691-fedc-4629-8b65-fed9fa59de46","name":"200 Success","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{jwt}}","type":"text","disabled":true}],"url":{"raw":"https://api.fapro.app/api/v1.2/company/list_docs_purchases?rut_deudor=&fecha_inicial=2026-01-01&fecha_final=2026-04-01","protocol":"https","host":["api","fapro","app"],"path":["api","v1.2","company","list_docs_purchases"],"query":[{"key":"rut_deudor","value":""},{"key":"fecha_inicial","value":"2026-01-01"},{"key":"fecha_final","value":"2026-04-01"},{"key":"rut_emisor","value":"","disabled":true},{"key":"folio","value":"","description":"int","disabled":true},{"key":"tipo_documento","value":"","description":"int","disabled":true},{"key":"facturas_cedidas","value":"","description":"boolean","disabled":true},{"key":"facturas_nota_credito","value":"","description":"boolean","disabled":true},{"key":"facturas_rechazadas","value":"","description":"boolean","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":":status","value":200},{"key":"date","value":"Fri, 24 Apr 2026 12:53:13 GMT"},{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"content-length","value":"1085"},{"key":"x-amzn-requestid","value":"493f26a6-9206-405b-b074-5e1b6a0cf11e"},{"key":"x-dns-prefetch-control","value":"off"},{"key":"referrer-policy","value":"no-referrer"},{"key":"x-permitted-cross-domain-policies","value":"none"},{"key":"access-control-allow-origin","value":""},{"key":"strict-transport-security","value":"max-age=31536000; includeSubDomains"},{"key":"x-amzn-remapped-content-length","value":"1085"},{"key":"x-frame-options","value":"SAMEORIGIN"},{"key":"content-security-policy","value":"connect-src 'self' https:;img-src 'self' data: blob: https://market-assets.strapi.io;media-src 'self' data: blob:;default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline'"},{"key":"x-origin-id","value":"strapi"},{"key":"x-amzn-remapped-connection","value":"keep-alive"},{"key":"x-download-options","value":"noopen"},{"key":"x-request-id","value":"7f9b1a94-dd61-440a-be56-2d01a63458c7"},{"key":"set-cookie","value":"AWSALB=UUIToU9+tXEv/BrvZLp1bIGU933dFMuKCyk/eXKYtriN8/CNa6hyMl5E/L0XuncLeX3UB8kmdxSKiIGfbFCeRDNHmncCFGJYCQ478R/qDPojAcP5RISXR0o3X0Vl; Expires=Fri, 01 May 2026 12:53:12 GMT; Path=/"},{"key":"set-cookie","value":"AWSALBCORS=UUIToU9+tXEv/BrvZLp1bIGU933dFMuKCyk/eXKYtriN8/CNa6hyMl5E/L0XuncLeX3UB8kmdxSKiIGfbFCeRDNHmncCFGJYCQ478R/qDPojAcP5RISXR0o3X0Vl; Expires=Fri, 01 May 2026 12:53:12 GMT; Path=/; SameSite=None; Secure"},{"key":"x-amz-apigw-id","value":"cU0k7G5_IAMEOyQ="},{"key":"vary","value":"Origin"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-powered-by","value":"StrapiDescripción: Esta API permite obtener la relación de cliente-deudor en un periodo de tiempo seleccionado.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/client_debtor_relationship
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"meses_con_venta\": 0,\n \"meses_consultados\": 5\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.meses_con_venta: Cantidad de meses dentro del periodo consultado en los que la empresa registró ventas (integer).
\ndata.meses_consultados: Cantidad total de meses incluidos en el rango de consulta (integer).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"El campo rut deudor seleccionado no existe.\",\n \"El campo fecha inicial es obligatorio.\",\n \"El campo fecha final es obligatorio.\"\n ]\n}\n\nDescripción: Esta API entrega el detalle mensual de las boletas registradas en el Registro de Compras y Ventas.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/boletas_venta
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": [\n {\n \"operacion\": \"VENTA\",\n \"estado\": \"REGISTRO\",\n \"dcv_codigo\": 3434344456,\n \"periodo\": 202603,\n \"tipo_documento\": 39,\n \"nombre_tipo_documento\": \"Total Oper. del mes Boleta Electr.\",\n \"total_documentos\": 3,\n \"monto_exento\": 0,\n \"monto_neto\": 2200000,\n \"iva_recuperable\": 418000,\n \"iva_uso_comun\": 0,\n \"iva_no_recuperable\": 0,\n \"monto_total\": 2618000\n }\n ],\n \"message\": \"Ejecucion correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Arreglo con los registros de resumen mensual de boletas de venta (array).
\ndata[].operacion: Tipo de operación tributaria. Valores esperados: \"VENTA\", \"COMPRA\" (string).
data[].estado: Estado del documento en el Registro de Compras y Ventas (RCV) del SII. Valores posibles: \"REGISTRO\", \"PENDIENTE\", \"NO_INCLUIR\", \"RECLAMADO\" (string).
data[].dcv_codigo: Identificador único del registro en el DCV/RCV del SII (integer).
\ndata[].periodo: Período tributario en formato AAAAMM (integer).
data[].tipo_documento: Código SII del tipo de Documento Tributario Electrónico. Valores que pueden obtenerse: 35, 38, 39, 41 y 48 (integer).
\ndata[].nombre_tipo_documento: Descripción legible del tipo de documento tributario Valores posibles: Total Oper. del mes Boleta Afecta, Total Oper. del mes Boleta Exenta, Total Oper. del mes Boleta Electr., Total Op. del mes Boleta Exenta Electr. y Total mes Comprobantes Pago Electrónico (string).
\ndata[].total_documentos: Cantidad de documentos emitidos en el período (integer).
\ndata[].monto_exento: Suma de montos exentos de IVA, expresada en pesos chilenos (integer).
\ndata[].monto_neto: Suma de montos netos sin IVA, expresada en pesos chilenos (integer).
\ndata[].iva_recuperable: Monto del IVA débito fiscal asociado a las ventas, expresado en pesos chilenos (integer).
\ndata[].iva_uso_comun: Monto del IVA de uso común, expresado en pesos chilenos (integer).
\ndata[].iva_no_recuperable: Monto del IVA no recuperable, expresado en pesos chilenos (integer).
\ndata[].monto_total: Monto total bruto del período (neto + IVA), expresado en pesos chilenos (integer).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El campo rut es obligatorio.\",\n \"errors\": [\n \"El campo rut es obligatorio.\"\n ]\n}\n\nDescripción: Esta API permite obtener el monto total que una empresa vinculada ha cedido a través de factoring durante un rango de fechas determinado. El periodo se construye en base a la fecha de cesión de cada documento.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/monto_cedido
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"Monto cedido\": \"0\",\n \"monto_cedido\": \"0\"\n },\n \"message\": \"Ejecucion correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).code: Código interno de la operación (integer).
data: Objeto principal con los datos de la consulta (object).
\ndata.Monto cedido: Monto total cedido por la empresa en el periodo consultado (string).
\ndata.monto_cedido: Monto total cedido por la empresa en el periodo consultado (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API obtiene la relación entre facturas reclamadas y el total cedido por la empresa en un rango de fechas.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/factura_rec_total_cedido
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"consolidado\": 0,\n \"deudores\": [\n {\n \"rut_deudor\": 10001,\n \"factura_reclamada_total_cedido\": 100212\n },\n {\n \"rut_deudor\": 10002,\n \"factura_reclamada_total_cedido\": 0\n },\n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.consolidado: Monto consolidado de facturas reclamadas sobre el total cedido por la empresa en el periodo consultado (integer).
\ndata.deudores: Listado con el detalle de facturas reclamadas sobre el total cedido, desagregado por cada deudor (array).
\ndata.deudores[].rut_deudor: RUT del deudor asociado a las facturas cedidas (integer).
\ndata.deudores[].factura_reclamada_total_cedido: Monto de facturas reclamadas sobre el total cedido correspondiente a ese deudor (integer).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"El campo fecha inicial es obligatorio.\",\n \"El campo fecha final es obligatorio.\"\n ]\n}\n\nDescripción: Esta API expone la consulta del monto adeudado por la empresa vinculada en función de un plazo de días específico.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/monto_pagar
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"monto_pagar\": \"1015646396\"\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Indica el estado general de la operación. El valor \"success\" señala que la consulta se ejecutó correctamente (string).
code: Código numérico interno asociado al resultado de la operación. El valor 1 representa una ejecución exitosa (integer).
data: Objeto que contiene la información devuelta por la consulta (object).
\ndata.monto_pagar: Monto a pagar por la empresa vinculada para el plazo de días consultado, expresado como cadena numérica (string).
\nmessage: Mensaje descriptivo del resultado de la operación (string).
\nDescripción: Esta API permite consultar el cruce de compras y ventas.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/cruce_compra_ventas
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"%_cruce_compra_ventas\": 0\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.%_cruce_compra_ventas: Procentaje obtenido del cruce compra venta (integer).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"El campo rut deudor seleccionado no existe.\",\n \"El campo fecha inicial es obligatorio.\",\n \"El campo fecha final es obligatorio.\"\n ]\n}\n\nDescripción: Esta API permite consultar los documentos tributarios electrónicos (DTEs) guardados en base de datos a partir de una serie de parámetros.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/get_dtes
\nAuthorization: Bearer {{jwt}}
\nNota: Se debe ingresar al menos uno de los siguientes RUT: rut_emisor o rut_deudor.
{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": \"27003792\",\n \"dhdr_codigo\": \"0\",\n \"folio\": \"1015\",\n \"tipo_documento\": \"33\",\n \"rut_emisor\": \"12345678\",\n \"dv_emisor\": \"7\",\n \"rz_emisor\": \"Nombre empresa emisora\",\n \"rut_receptor\": \"98764321\",\n \"dv_receptor\": \"9\",\n \"rz_receptor\": \"Nombre empresa receptora.\",\n \"detFchDoc\": \"2025-08-12\",\n \"detFecReclamado\": null,\n \"detFecRecepcion\": \"2025-08-12\",\n \"detMntTotal\": \"7149781\",\n \"detFolioDocRef\": null,\n \"detTipoDocRef\": \"0\",\n \"detPcarga\": \"202508\",\n \"detEventoReceptor\": null,\n \"detEventoReceptorLeyenda\": null,\n \"detPTributario\": \"202508\",\n \"company_id_emisora\": null,\n \"company_id_receptora\": \"4877\",\n \"created_at\": \"2025-09-05 13:40:01.443\",\n \"updated_at\": \"2026-03-04 03:25:32.717\"\n }\n ],\n \"first_page_url\": \"https://ejemplo1.fapro.cl/api/v1.0/company/get_dtes?page=1\",\n \"from\": 1,\n \"last_page\": 1,\n \"last_page_url\": \"https://ejemplo2.fapro.cl/api/v1.0/company/get_dtes?page=1\",\n \"links\": [\n {\n \"url\": null,\n \"label\": \"« Anterior\",\n \"active\": false\n },\n {\n \"url\": \"https://ejemplo3.fapro.cl/api/v1.0/company/get_dtes?page=1\",\n \"label\": \"1\",\n \"active\": true\n },\n {\n \"url\": null,\n \"label\": \"Siguiente »\",\n \"active\": false\n }\n ],\n \"next_page_url\": null,\n \"path\": \"https://ejemplo4.fapro.cl/api/v1.0/company/get_dtes\",\n \"per_page\": 1000,\n \"prev_page_url\": null,\n \"to\": 20,\n \"total\": 20\n },\n \"message\": \"Ejecucion correcta.\"\n}\n\nCaso 2 : Respuesta sin datos.
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": [],\n \"message\": \"No hay documentos con el rut 12345789-6 en el rango de fechas dado.\"\n}\n\ncode: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta y la información de paginación (object). Retorna un array vacío ([]) cuando no se encuentran documentos.
data.current_page: Página actual del resultado paginado (integer).
\ndata.data: Listado de documentos tributarios encontrados (array).
\ndata.data[].id: ID del documento en la base de datos, si es que está vinculado (string).
\ndata.data[].dhdr_codigo: Código único del documento desde la fuente de origen (string).
\ndata.data[].folio: Folio del documento (string).
\ndata.data[].tipo_documento: Tipo de documento. Ver Anexo Listado de Tipos de Documentos del SII (string).
\ndata.data[].rut_emisor: RUT del emisor del documento (string).
\ndata.data[].dv_emisor: Dígito verificador del emisor del documento (string).
\ndata.data[].rz_emisor: Razón social del emisor del documento (string).
\ndata.data[].rut_receptor: RUT del receptor del documento (string).
\ndata.data[].dv_receptor: Dígito verificador del receptor del documento (string).
\ndata.data[].rz_receptor: Razón social del receptor del documento (string).
\ndata.data[].detFchDoc: Fecha del documento, ingresada por el emisor. Formato: YYYY-MM-DD (date).
data.data[].detFecReclamado: Fecha de reclamo del documento en el SII. Formato: YYYY-MM-DD (datetime, nullable).
data.data[].detFecRecepcion: Fecha de recepción del documento en el SII. Formato: YYYY-MM-DD (datetime).
data.data[].detMntTotal: Monto total del documento, expresado en pesos chilenos (string).
\ndata.data[].detFolioDocRef: Folio del documento referenciado (string, nullable).
\ndata.data[].detTipoDocRef: Tipo de documento referenciado (string, nullable).
\ndata.data[].detPcarga: Periodo de carga del documento. Formato: YYYYMM (string).
data.data[].detEventoReceptor: Evento del documento. Ver A_nexo_ Listado de Eventos de Receptor (string, nullable).
\ndata.data[].detEventoReceptorLeyenda: Leyenda del evento del documento. Ver Anexo Listado de Eventos de Receptor (string, nullable).
\ndata.data[].detPTributario: Periodo tributario del documento. Formato: YYYYMM (string).
data.data[].company_id_emisora: ID de la empresa emisora, si está vinculada (string, nullable).
\ndata.data[].company_id_receptora: ID de la empresa receptora, si está vinculada (string, nullable).
\ndata.data[].created_at: Fecha de creación del documento en la base de datos. Formato: YYYY-MM-DD HH:MM:SS.sss (datetime, nullable).
data.data[].updated_at: Fecha de actualización del documento en la base de datos. Formato: YYYY-MM-DD HH:MM:SS.sss (datetime, nullable).
data.first_page_url: URL de la primera página del resultado paginado (string).
\ndata.from: Índice del primer registro de la página actual (integer).
\ndata.last_page: Número de la última página disponible (integer).
\ndata.last_page_url: URL de la última página del resultado paginado (string).
\ndata.links: Listado de enlaces de navegación entre páginas (array).
\ndata.links[].url: URL de la página correspondiente. null si no aplica (string, nullable).
data.links[].label: Etiqueta del enlace de navegación (string).
\ndata.links[].active: Indica si el enlace corresponde a la página actual (boolean).
\ndata.next_page_url: URL de la siguiente página. null si no existe (string, nullable).
data.path: URL base del endpoint (string).
\ndata.per_page: Cantidad de registros por página (integer).
\ndata.prev_page_url: URL de la página anterior. null si no existe (string, nullable).
data.to: Índice del último registro de la página actual (integer).
\ndata.total: Cantidad total de registros encontrados (integer).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El campo fecha inicial es obligatorio.\",\n \"errors\": [\n \"El campo fecha inicial es obligatorio.\",\n \"El campo fecha final es obligatorio.\",\n \"Al menos uno de rut_emisor o rut_deudor es requerido.\"\n ]\n}\n\nDescripción: Esta API permite consultar las cesiones guardadas en base de datos a partir de una serie de parámetros.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/company/cesions
\nAuthorization: Bearer {{jwt}}
\nNota: Se debe ingresar al menos uno de los siguientes RUT: rut_cedente, rut_deudor o rut_cesionario.
{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": \"643336\",\n \"folio\": \"178\",\n \"tipo_documento\": \"33\",\n \"rut_cedente\": \"12345678\",\n \"dv_cedente\": \"9\",\n \"rz_cedente\": \"Nombre de la empresa cedente\",\n \"mail_cedente\": \"email@empresacedente.com\",\n \"rut_deudor\": \"12349876\",\n \"dv_deudor\": \"5\",\n \"rz_deudor\": null,\n \"mail_deudor\": \"email@maildeudor.com\",\n \"company_id_deudora\": \"1450\",\n \"rut_cesionario\": \"67891234\",\n \"dv_cesionario\": \"9\",\n \"rz_cesionario\": \"Nombre empresa cesionaria\",\n \"mail_cesionario\": \"mail@emoresacesionaria.com\",\n \"rut_emisor\": \"678324567\",\n \"dv_emisor\": \"2\",\n \"rz_emisor\": \"Nombre emoresa emisora\",\n \"company_id_emisora\": null,\n \"doc_id\": null,\n \"monto_cesion\": \"9557052\",\n \"monto_documento\": \"9557052\",\n \"fecha_cesion\": \"2025-06-10\",\n \"fecha_emision\": \"2024-01-17\",\n \"fecha_vencimiento\": \"2024-01-17\",\n \"periodo\": \"202401\",\n \"created_at\": \"2024-03-15 11:52:14.193\",\n \"updated_at\": \"2026-04-16 14:49:02.493\"\n }\n ],\n \"first_page_url\": \"https://ejemplo.fapro.cl/api/v1.0/company/cesions?page=1\",\n \"from\": 1,\n \"last_page\": 1,\n \"last_page_url\": \"https://ejemplo2.fapro.cl/api/v1.0/company/cesions?page=1\",\n \"links\": [\n {\n \"url\": null,\n \"label\": \"« Anterior\",\n \"active\": false\n },\n {\n \"url\": \"https://ejemplo3.fapro.cl/api/v1.0/company/cesions?page=1\",\n \"label\": \"1\",\n \"active\": true\n },\n {\n \"url\": null,\n \"label\": \"Siguiente »\",\n \"active\": false\n }\n ],\n \"next_page_url\": null,\n \"path\": \"https://ejemplo4.fapro.cl/api/v1.0/company/cesions\",\n \"per_page\": 1000,\n \"prev_page_url\": null,\n \"to\": 1,\n \"total\": 1\n },\n \"message\": \"Ejecucion correcta.\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta y la información de paginación (object).
\ndata.current_page: Página actual del resultado paginado (integer).
\ndata.data: Listado de cesiones encontradas (array).
\ndata.data[].id: ID de la cesión en la base de datos (string).
\ndata.data[].folio: Folio del documento asociado a la cesión (string).
\ndata.data[].tipo_documento: Tipo de documento asociado a la cesión. Ver Anexo Tipos de Documentos (string).
\ndata.data[].rut_cedente: RUT del cedente de la cesión (string).
\ndata.data[].dv_cedente: Dígito verificador del cedente de la cesión (string).
\ndata.data[].rz_cedente: Razón social del cedente de la cesión (string).
\ndata.data[].mail_cedente: Mail del cedente de la cesión (string, nullable).
\ndata.data[].rut_deudor: RUT del deudor de la cesión (string).
\ndata.data[].dv_deudor: Dígito verificador del deudor de la cesión (string).
\ndata.data[].rz_deudor: Razón social del deudor de la cesión (string, nullable).
\ndata.data[].mail_deudor: Mail del deudor de la cesión (string, nullable).
\ndata.data[].company_id_deudora: ID de la empresa receptora (string, nullable).
\ndata.data[].rut_cesionario: RUT del cesionario de la cesión (string).
\ndata.data[].dv_cesionario: Dígito verificador del cesionario de la cesión (string).
\ndata.data[].rz_cesionario: Razón social del cesionario de la cesión (string).
\ndata.data[].mail_cesionario: Mail del cesionario de la cesión (string, nullable).
\ndata.data[].rut_emisor: RUT del emisor de la cesión (string).
\ndata.data[].dv_emisor: Dígito verificador del emisor de la cesión (string).
\ndata.data[].rz_emisor: Razón social del emisor de la cesión (string).
\ndata.data[].company_id_emisora: ID de la empresa emisora (string, nullable).
\ndata.data[].doc_id: ID del documento asociado a la cesión (string, nullable).
\ndata.data[].monto_cesion: Monto de la cesión expresado en pesos chilenos (string).
\ndata.data[].monto_documento: Monto de emisión del documento asociado a la cesión, expresado en pesos chilenos (string).
\ndata.data[].fecha_cesion: Fecha de la cesión. Formato: YYYY-MM-DD (date).
data.data[].fecha_emision: Fecha de emisión del documento asociado a la cesión. Formato: YYYY-MM-DD (date).
data.data[].fecha_vencimiento: Fecha de vencimiento de la cesión. Formato: YYYY-MM-DD (date, nullable).
data.data[].periodo: Periodo de consulta de la cesión. Formato: YYYYMM (string).
data.data[].created_at: Fecha de creación de la cesión en la base de datos. Formato: YYYY-MM-DD HH:MM:SS.sss (datetime, nullable).
data.data[].updated_at: Fecha de actualización de la cesión en la base de datos. Formato: YYYY-MM-DD HH:MM:SS.sss (datetime, nullable).
data.first_page_url: URL de la primera página del resultado paginado (string).
\ndata.from: Índice del primer registro de la página actual (integer).
\ndata.last_page: Número de la última página disponible (integer).
\ndata.last_page_url: URL de la última página del resultado paginado (string).
\ndata.links: Listado de enlaces de navegación entre páginas (array).
\ndata.links[].url: URL de la página correspondiente. null si no aplica (string, nullable).
data.links[].label: Etiqueta del enlace de navegación (string).
\ndata.links[].active: Indica si el enlace corresponde a la página actual (boolean).
\ndata.next_page_url: URL de la siguiente página. null si no existe (string, nullable).
data.path: URL base del endpoint (string).
\ndata.per_page: Cantidad de registros por página (integer).
\ndata.prev_page_url: URL de la página anterior. null si no existe (string, nullable).
data.to: Índice del último registro de la página actual (integer).
\ndata.total: Cantidad total de registros encontrados (integer).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"Debe ingresar al menos un RUT (cedente y/o deudor y/o cesionario)\",\n \"errors\": [\n \"Debe ingresar al menos un RUT (cedente y/o deudor y/o cesionario)\"\n ]\n}\n\nDescripción: Esta API nos devuelve los convenios vigentes relacionados a un rut. Nos brinda detalle del total de los mismos y ademas nos brinda información sobre la situación en que se encuentran actualmente.
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/tgr/quotas
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"tgr_agreements\": [\n {\n \"id\": \"9520\",\n \"number\": \"1\",\n \"resolution_number\": \"878777\",\n \"resolution_date\": \"2026-04-10\",\n \"residue\": \"52669624\",\n \"overdue_count\": 0,\n \"overdue_amount\": 0,\n \"quotas\": [\n {\n \"number\": \"1\",\n \"expiration_date\": \"2026-04-30\",\n \"amount\": \"999988888\",\n \"paid\": \"SI\",\n \"state\": \"Pagada\",\n \"tgr_agreement_id\": \"1020\"\n },\n {\n \"number\": \"2\",\n \"expiration_date\": \"2026-05-31\",\n \"amount\": \"4653710\",\n \"paid\": \"NO\",\n \"state\": \"Al dia\",\n \"tgr_agreement_id\": \"9520\"\n }\n ]\n }\n ]\n },\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.tgr_agreements: Listado de convenios registrados ante la Tesorería General de la República (TGR) asociados a la empresa consultada (array).
\ndata.tgr_agreements[].id: Identificador único del convenio en la base de datos (string).
\ndata.tgr_agreements[].number: Número del convenio (string).
\ndata.tgr_agreements[].resolution_number: Número de resolución asociada al convenio (string).
\ndata.tgr_agreements[].resolution_date: Fecha de la resolución del convenio. Formato: YYYY-MM-DD (date).
data.tgr_agreements[].residue: Saldo residual del convenio, expresado en pesos chilenos (string).
\ndata.tgr_agreements[].overdue_count: Cantidad de cuotas vencidas e impagas del convenio (integer).
\ndata.tgr_agreements[].overdue_amount: Monto total adeudado correspondiente a las cuotas vencidas, expresado en pesos chilenos (integer).
\ndata.tgr_agreements[].quotas: Listado de cuotas asociadas al convenio (array).
\ndata.tgr_agreements[].quotas[].number: Número de la cuota dentro del convenio (string).
\ndata.tgr_agreements[].quotas[].expiration_date: Fecha de vencimiento de la cuota. Formato: YYYY-MM-DD (date).
data.tgr_agreements[].quotas[].amount: Monto de la cuota, expresado en pesos chilenos (string).
\ndata.tgr_agreements[].quotas[].state: Estado de la cuota. Valores posibles: \"Pagada\", \"Al dia\", entre otros (string).
data.tgr_agreements[].quotas[].tgr_agreement_id: ID del convenio TGR al que pertenece la cuota (string).
\nmessage: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Esta API te permite consultar el certificado de deuda fiscal, con la respectiva deuda en convenio y el detalle de los convenios vigentes
\nMétodo: GET
\nURL: https://api.fapro.app/api/v1.0/tgr/debt_certificate
\nAuthorization: Bearer {{jwt}}
\n{\n \"status\": \"success\",\n \"code\": 1,\n \"data\": {\n \"tgr_certificate_debt_agreements\": [\n {\n \"folio\": \"454545\",\n \"form\": \"21\",\n \"expiration_date\": \"2023-08-14\",\n \"total\": \"30059228\",\n \"tgr_agreement_resolution_number\": \"989\",\n \"saldo\": \"27202921\",\n \"debt_condonation\": \"\",\n \"debt_interest\": \"2924621\",\n \"debt_amount\": \"27202921\",\n \"debt_penalty\": \"8593403\",\n \"debt_readjustment\": \"\",\n \"has_tgr_agreement\": true\n },\n ]\n }\n \"message\": \"Ejecución correcta\"\n}\n\nstatus: Estado de la respuesta. Valor esperado: \"success\" (string).
code: Código interno de la operación (integer).
\ndata: Objeto principal con los datos de la consulta (object).
\ndata.tgr_certificate_debt_agreements: Listado de deudas certificadas por la Tesorería General de la República (TGR) asociadas a la empresa consultada (array).
\ndata.tgr_certificate_debt_agreements[].folio: Número de folio del formulario asociado a la deuda (string).
\ndata.tgr_certificate_debt_agreements[].form: Código del formulario asociado a la deuda (string).
\ndata.tgr_certificate_debt_agreements[].expiration_date: Fecha de vencimiento de la deuda. Formato: YYYY-MM-DD (date).
data.tgr_certificate_debt_agreements[].total: Monto total original de la deuda, expresado en pesos chilenos (string).
\ndata.tgr_certificate_debt_agreements[].tgr_agreement_resolution_number: Número de resolución del convenio TGR asociado a la deuda (string).
\ndata.tgr_certificate_debt_agreements[].saldo: Saldo pendiente de la deuda, expresado en pesos chilenos (string).
\ndata.tgr_certificate_debt_agreements[].debt_condonation: Monto condonado de la deuda, expresado en pesos chilenos. Vacío si no aplica (string).
\ndata.tgr_certificate_debt_agreements[].debt_interest: Monto correspondiente a intereses de la deuda, expresado en pesos chilenos (string).
\ndata.tgr_certificate_debt_agreements[].debt_amount: Monto principal adeudado, expresado en pesos chilenos (string).
\ndata.tgr_certificate_debt_agreements[].debt_penalty: Monto correspondiente a multas aplicadas a la deuda, expresado en pesos chilenos (string).
\ndata.tgr_certificate_debt_agreements[].debt_readjustment: Monto correspondiente a reajustes de la deuda, expresado en pesos chilenos. Vacío si no aplica (string).
\ndata.tgr_certificate_debt_agreements[].has_tgr_agreement: Indica si la deuda tiene un convenio TGR asociado. Valores posibles: true, false (boolean).
message: Mensaje descriptivo del resultado (string).
\n422 Unprocessable Entity
\n{\n \"status\": \"error\",\n \"code\": 0,\n \"data\": [],\n \"message\": \"El rut proporcionado no existe en la base de datos o no esta vinculado\",\n \"errors\": [\n \"El rut proporcionado no existe en la base de datos o no esta vinculado\"\n ]\n}\n\nDescripción: Indica si la empresa está vinculada y operativa en la cuenta. Determina si corresponde consultar los endpoints de empresa vinculada o sus pares /sii, por lo que conviene consultarlo antes de solicitar cualquier dato.
Responde siempre 200. Un RUT que no pertenece a la cartera no constituye un error: se informa como conectada: false.
Método: GET
\nURL: {{host}}/api/v2/empresas/{rut}/estado
\nAutenticación
\nAuthorization: Bearer {{jwt}}
\nHeaders
\n{\n \"status\": \"success\",\n \"data\": {\n \"conectada\": true\n },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-08-12T18:11:46.441Z\"\n }\n}\nconectada: false agrupa tres situaciones: la empresa no está en la cartera, sus credenciales dejaron de funcionar, o fue deshabilitada. Para efectos de elegir el endpoint las tres son equivalentes. Para distinguirlas, consultar GET /api/v1.0/company/profile?rut={rut}.
Este endpoint no devuelve 404 ni 422 por el RUT: un RUT desconocido responde 200 con conectada: false.
RUT de la empresa, formato XXXXXXXX-X.
\n","type":"text/plain"},"type":"any","value":"","key":"rut"}]}},"response":[{"id":"9c2e2d91-03d1-1210-b01a-7af348f64636","name":"200","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{jwt}}"}],"url":{"raw":"{{host}}/api/v2/empresas/:rut/estado","host":["{{host}}"],"path":["api","v2","empresas",":rut","estado"],"variable":[{"id":"390c59f3-7aaa-4977-9cb1-cf0d21460c91","key":"rut","value":"","description":"RUT de la empresa, formato XXXXXXXX-X."}]},"description":"### **API Endpoint: Estado de empresa**\n\n**Descripción:** Indica si la empresa está vinculada y operativa en la cuenta. Determina si corresponde consultar los endpoints de empresa vinculada o sus pares `/sii`, por lo que conviene consultarlo antes de solicitar cualquier dato.\n\nResponde **siempre 200**. Un RUT que no pertenece a la cartera no constituye un error: se informa como `conectada: false`.\n\n**Método:** GET\n\n**URL:** {{host}}/api/v2/empresas/{rut}/estado\n\n**Autenticación**\n\nAuthorization: Bearer {{jwt}}\n\n**Headers**\n\n| **Header** | **Tipo** | **Obligatorio** | **Descripción** |\n| --- | --- | --- | --- |\n| Content-Type | string | NO | application/json |\n| Authorization | string | SI | Access token del usuario (login). |\n\n#### Path Params\n\n| **Campo** | **Tipo** | **Obligatorio** | **Descripción** |\n| --- | --- | --- | --- |\n| rut | string | SI | RUT de la empresa, formato XXXXXXXX-X. |\n\n#### **Respuesta Exitosa**\n\n- **Status Code**: 200\n\n##### Estructura de respuesta exitosa:\n\n``` json\n{\n \"status\": \"success\",\n \"data\": {\n \"conectada\": true\n },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-08-12T18:11:46.441Z\"\n }\n}\n```\n\n#### **Descripción de la Respuesta**\n\n| **Campo** | **Tipo** | **Descripción** |\n| --- | --- | --- |\n| conectada | boolean | `true` si Fapro puede consultar el SII en nombre de esta empresa. `false` en cualquier otro caso. |\n\n#### Qué endpoint corresponde según la respuesta\n\n| conectada | Endpoints a utilizar |\n| --- | --- |\n| `true` | `/empresas/{rut}/categoria` · `/empresas/{rut}/actividades-economicas` |\n| `false` | `/empresas/{rut}/categoria/sii` · `/empresas/{rut}/actividades-economicas/sii` |\n\n`conectada: false` agrupa tres situaciones: la empresa no está en la cartera, sus credenciales dejaron de funcionar, o fue deshabilitada. Para efectos de elegir el endpoint las tres son equivalentes. Para distinguirlas, consultar `GET /api/v1.0/company/profile?rut={rut}`.\n\n#### **Respuestas de Error**\n\n- 401 Unauthorized: token ausente o inválido.\n- 500 Internal Server Error: error interno.\n\nEste endpoint **no devuelve 404 ni 422 por el RUT**: un RUT desconocido responde 200 con `conectada: false`."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"conectada\": true\n },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-08-12T18:11:46.441Z\"\n }\n}"}],"_postman_id":"5bf7a771-3b4b-ce0f-98c4-732453943f56"},{"name":"Listado de empresas","id":"ef634a53-ebdb-4ffd-98c1-2c38cd632025","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{jwt}}","type":"text"}],"url":"{{host}}/api/v2/companies?page=0&page_size=1&connected=0","description":"Descripción: Devuelve las empresas de la cartera de la cuenta, paginadas, con filtro opcional por estado de conexión.
\nMétodo: GET
\nURL: {{host}}/api/v2/companies?page={page}&page_size={page_size}&connected={connected}
\nAutenticación
\nAuthorization: Bearer {{jwt}}
\nHeaders
\n{\n \"data\": [\n {\n \"identifier\": \"XXXXXXXX-X\",\n \"business_name\": \"Mi empresa spa\",\n \"token_date\": \"2026-03-23T10:30:32.21Z\",\n \"created_at\": \"2026-03-23T13:29:43.5Z\",\n \"executive\": \"info@correo.com\",\n \"authentication\": \"password\",\n \"connected\": \"true\",\n \"es_mipyme\": \"1\",\n \"disable_date\": null,\n \"start_activities_date\": null,\n \"custom_field\": []\n }\n ],\n \"pagination\": {\n \"page\": 0,\n \"page_size\": 1,\n \"total_items\": 1,\n \"total_pages\": 1\n },\n \"metadata\": {\n \"request_id\": \"94dfd9de-f525-449b-91de-23252a27b689\"\n }\n}\n\n\nUna empresa con
\nconnected: \"true\"pero condisable_dateinformado no está operativa. Para determinar a qué endpoint de datos corresponde consultar, utilizar/empresas/{rut}/estado, que ya considera ambos campos.
page o page_size ausentes o inválidos.{\n \"data\": null,\n \"error\": {\n \"status\": 401,\n \"name\": \"UnauthorizedError\",\n \"message\": \"Missing or invalid credentials\",\n \"details\": {}\n }\n}\nDescripción: Retorna la categoría de tamaño y el tramo SII de una empresa vinculada, calculados por Fapro a partir de sus ventas del último año móvil convertidas a UF.
\nPara empresas no vinculadas corresponde /empresas/{rut}/categoria/sii, que lee el tramo publicado por el SII. Ese endpoint no entrega monto de ventas.
Método: GET
\nURL: {{host}}/api/v2/empresas/{rut}/categoria
\nAutenticación
\nAuthorization: Bearer {{jwt}}
\nHeaders
\n{\n \"status\": \"success\",\n \"data\": {\n \"categoria\": \"Micro Empresa\",\n \"tramo\": 4,\n \"tramo_label\": \"3ro Rango Micro Empresa\",\n \"tiene_datos\": true,\n \"venta_clp\": 25354150,\n \"venta_uf\": 620.74\n },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-08-12T18:11:46.441Z\"\n }\n}\ntiene_datos: por qué existeUna empresa que vendió 0 y una empresa de la que Fapro no dispone de documentos devuelven los mismos números: venta_clp: 0, tramo: 1. tiene_datos es el único campo que las distingue.
No debe interpretarse venta_clp: 0 como \"no vendió\" sin comprobar antes tiene_datos.
Aplica a este endpoint y a /categoria/sii.
Una empresa sin ventas no constituye un error: responde 200 con tramo: 1 y venta_clp: 0.
{\n \"status\": \"error\",\n \"message\": \"Error de servidor\",\n \"data\": null,\n \"error\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\"\n }\n}\nDescripción: Retorna el tramo de tamaño publicado por el SII en la nómina de personas jurídicas (dato nacional cargado por Fapro). Es el tramo oficial del SII, no un cálculo sobre los DTE del tenant; sirve de respaldo para empresas sin documentos tributarios disponibles.
\nMétodo: GET
\nURL: {{host}}/api/v2/empresas/{rut}/categoria/sii
\nAutenticación
\nAuthorization: Bearer {{jwt}}
\nHeaders
\n{\n \"status\": \"success\",\n \"data\": {\n \"categoria\": \"Pequeña Empresa\",\n \"tramo\": 5,\n \"tramo_label\": \"1er Rango Pequeña Empresa\",\n \"anio\": 2024\n },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-07-27T18:11:46.441Z\"\n }\n}\n\n\nEste endpoint responde con las mismas keys y los mismos tipos que
\n/empresas/{rut}/categoria. La única diferencia es que aquí no se informanventa_clpniventa_uf: la nómina del SII no publica montos de venta.
tramo utiliza el mismo vocabulario que /empresas/{rut}/categoria, por lo que los valores de ambos endpoints son comparables directamente.
Este endpoint lee la Nómina de Personas Jurídicas del SII, que no incluye personas naturales: una persona natural con giro responde 404. Tampoco entrega monto de ventas; para obtenerlo la empresa debe estar vinculada.
El RUT proporcionado no es válido (dígito verificador incorrecto).Descripción: Retorna las actividades económicas registradas de la empresa según la carpeta tributaria del SII almacenada por Fapro (base del tenant). Incluye la glosa general (giro) y el detalle de cada actividad con su código, categoría tributaria, fecha de inicio y si afecta IVA.
\nMétodo: GET
\nURL: {{host}}/api/v2/empresas/{rut}/actividades-economicas
\nAutenticación
\nAuthorization: Bearer {{jwt}}
\nHeaders
\n{\n \"status\": \"success\",\n \"data\": {\n \"glosa_general\": \"Actividades de programación informática\",\n \"actividades\": [\n {\n \"codigo\": \"620100\",\n \"glosa\": \"Actividades de programación informática\",\n \"categoria\": \"1\",\n \"fecha_inicio\": \"2019-03-01\",\n \"afecta_iva\": true\n }\n ]\n },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-07-27T18:11:46.441Z\"\n }\n}\n{\n \"status\": \"error\",\n \"message\": \"no economic activities found for identifier\",\n \"data\": {\n \"error\": \"not_found\",\n \"message\": \"no economic activities found for identifier\"\n },\n \"error\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\"\n }\n}\nDescripción: Consulta EN VIVO la situación tributaria de terceros (STC) del SII y retorna las actividades económicas de la empresa. A diferencia de actividades-economicas, no lee la base del tenant sino que scrapea el SII al momento; por eso puede demorar más y no incluye glosa_general.
Método: GET
\nURL: {{host}}/api/v2/empresas/{rut}/actividades-economicas/sii
\nAutenticación
\nAuthorization: Bearer {{jwt}}
\nHeaders
\n{\n \"status\": \"success\",\n \"data\": {\n \"actividades\": [\n {\n \"codigo\": \"620100\",\n \"glosa\": \"Actividades de programación informática\",\n \"categoria\": \"1\",\n \"fecha_inicio\": \"2019-03-01\",\n \"afecta_iva\": true\n }\n ]\n },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-07-27T18:11:46.441Z\"\n }\n}\n{\n \"status\": \"error\",\n \"message\": \"El RUT proporcionado no es válido\",\n \"data\": [],\n \"error\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\"\n }\n}\nDescripción: Consulta EN VIVO la situación tributaria del SII y clasifica al contribuyente. Retorna uno de: Empresa, Persona Natural con giro o Persona Natural.
Método: GET
\nURL: {{host}}/api/v2/empresas/{rut}/tipo-contribuyente/sii
\nAutenticación
\nAuthorization: Bearer {{jwt}}
\nHeaders
\n{\n \"status\": \"success\",\n \"data\": {\n \"tipo_contribuyente\": \"Empresa\"\n },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-07-27T18:11:46.441Z\"\n }\n}\n{\n \"status\": \"error\",\n \"message\": \"El RUT proporcionado no es válido\",\n \"data\": [],\n \"error\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\"\n }\n}\nLa API v2 entrega un dato por endpoint. Fapro no clasifica ni combina: cada endpoint devuelve un dato y el sistema consumidor aplica sus propias reglas.
\nCada dato tiene dos endpoints, no uno. Cuál corresponde depende de si la empresa está vinculada a la cuenta.
\nPOST /api/v1.0/login devuelve un token válido por 12 horas.GET /api/v2/empresas/{rut}/estado responde { \"conectada\": true | false }.La diferencia relevante: la rama vinculada entrega el monto exacto de ventas; la pública, solo el tramo. Si se requiere el monto, la empresa debe estar vinculada.
\nQue la empresa entregó sus credenciales del SII y Fapro puede consultar el portal en su nombre. La vinculación se realiza con POST /api/v1.0/company/create_from_password o con certificado digital.
conectada es un valor por cuenta: una misma empresa puede estar vinculada a una cuenta y no a la de otro cliente.
conectada responde false en tres situaciones y, para efectos de elegir el endpoint, las tres son equivalentes:
Para distinguirlas, consultar GET /api/v1.0/company/profile?rut={rut}.
Una persona natural con giro que no esté vinculada no tiene tramo. El tramo público proviene de la Nómina de Personas Jurídicas del SII, que no incluye personas naturales. En ese caso /categoria/sii responde 404. La única forma de obtener su tramo es vincular la empresa.
Todas las respuestas v2 comparten la misma estructura:
\n{\n \"status\": \"success\",\n \"data\": { },\n \"metadata\": {\n \"request_id\": \"b3d9c1e2-0000-0000-0000-000000000000\",\n \"timestamp\": \"2026-08-12T18:11:46.441Z\"\n }\n}\nSe recomienda conservar el request_id: es el identificador que permite rastrear una consulta ante una solicitud a soporte.