Implementar modos de operación es el cambio de esta actualización en la API de Siigo; la cual busca categorizar con mayor precisión las operaciones del sector salud, optimizar los procesos de facturación y garantizar el cumplimiento normativo.
1. A partir del 22 de julio de 2025, se incorpora un nuevo campo obligatorio en el objeto “healthcare_company” denominado “operation_type”, el cual debe incluirse cuando el tipo de factura de venta esté configurado para uso en el sector salud.
2. Los valores permitidos para “operation_type” son:
- “SS-Recaudo”
- “SS-SinAporte”
- “SS-CUFE”
3. SS-CUFE: este tipo de operación se utiliza para registrar el recaudo de copagos, cuotas moderadoras o anticipos.
- Incluye los campos “period_start” y “period_end” dentro del objeto “healthcare_company”.
- Debes incluir al menos uno de los siguientes campos de recaudo: “copayment”, “coinsurance”, “cost_sharing” y “recovery_charge”; los demás campos continuarán con las validaciones actuales.
- La suma de estos valores debe restarse del valor total de la factura, como se hace actualmente en el objeto “payments”.
Ejemplo: se muestra cómo manejar el valor total de la factura considerando los valores de recaudo en el objeto “healthcare_company”.
4. SS-SinAporte: se refiere a servicios de salud prestados sin que los afiliados al régimen contributivo paguen cuotas moderadoras o copagos.
- Incluye los campos “period_start” y “period_end” dentro del objeto “healthcare_company”.
- No se deben incluir los siguientes campos de recaudo: “copayment”, “coinsurance”, “cost_sharing” y “recovery_charge”.
Ejemplo: muestra cómo estructurar la factura sin valores de recaudo.
5. SS-Recaudo: este tipo de factura se utiliza cuando el prestador de servicios de salud (PSS) recauda dinero en lugar de la entidad responsable de pago (ERP).
- Solo debes enviar el campo “operation_type” dentro del objeto “healthcare_company”.
- No se deben incluir los demás campos del objeto.
Ejemplo: muestra la estructura mínima requerida.
6. Al emitir una nota crédito sobre una factura de venta creada en Siigo Nube:
- El tipo de operación en la nota crédito debe coincidir con el de la factura de venta relacionada.
- Las validaciones de los demás campos del objeto “healthcare_company” serán iguales a las mencionadas anteriormente para facturas de venta.
Para conocer más detalles sobre el funcionamiento de la API, puedes consultar nuestra documentación. Si tienes alguna duda, contáctanos a través del correo soporteapi.aliados@siigo.com.
Esperamos que esta mejora facilite tus procesos y contribuya a una gestión más precisa de las operaciones del sector salud.
3 comentarios en “Implementar modos de operación para empresas del sector salud”
Esta configuracion donde se realiza?.
Buen día Jorge, para conocer más detalles sobre el funcionamiento de la API, puedes consultar nuestra documentación. Si tienes alguna duda, contáctanos a través del correo soporteapi.aliados@siigo.com.
Buen día, Jorge.
Espero que te encuentres muy bien. Te comento que esta configuración debe ser realizada por tu integrador de software o por la persona que llevó a cabo la integración vía API, ya que es necesario modificar parte del código para implementarla.
Saludos cordiales.