Planillas y honorarios
Gestiona trabajadores, liquidaciones y registros de honorarios por emisor desde tu integración.
La API laboral está disponible con tu API key. La raíz es:
El RUC debe pertenecer a tu workspace y al modo de la clave. asu_test_ y asu_live_ tienen datos independientes.
Rutas disponibles
| Método | Ruta relativa | Operación |
|---|---|---|
| GET | /regimes | Políticas y regímenes laborales |
| GET / POST | /employees | Listar o crear trabajadores |
| PUT | /employees/{id} | Actualizar un trabajador |
| GET / POST | /runs | Listar o calcular una planilla en borrador |
| PUT | /runs/{id} | Recalcular un borrador |
| POST | /runs/{id}/status | Aprobar, registrar pago o anular localmente |
| GET / POST | /receipts | Listar o registrar honorarios |
| PUT | /receipts/{id} | Editar un borrador de honorarios |
| POST | /receipts/{id}/payments | Registrar un pago realizado |
| POST | /receipts/{id}/void | Anular el registro local de honorarios |
Las respuestas de lista son arrays. Las actualizaciones llevan revision con el valor de la última lectura; si cambió, recarga antes de guardar. Los esquemas completos están en la sección Laboral de Referencia API.
Crear un trabajador
Los importes están en céntimos de sol, sin decimales flotantes. 200000 representa S/ 2,000.00. Antes de calcular una planilla, indica la RMV vigente de su período y los conceptos de cada trabajador.
ONP y EsSalud se calculan en el servidor. AFP, quinta categoría, CTS, gratificaciones, vacaciones y aportes especiales reciben los importes que verificó el contador para ese período. No se deduce un régimen legal únicamente por el nombre de la empresa.
Estados y pagos
Una planilla pasa de draft a approved o void. Una aprobada puede pasar a paid o void. Un pago exige fecha y referencia de un pago ya realizado; esta API no transfiere dinero. Una planilla aprobada conserva su cálculo y no se edita.
Qué significa registrar honorarios
Puedes preparar un borrador y registrar el recibo que ya fue emitido en SUNAT con su serie y número, además de los pagos recibidos. La anulación de esta API modifica el registro local.
Esta API no emite ni anula RHE ante SUNAT. La emisión fiscal se realiza mediante el proceso autorizado SEE-SOL del profesional. Un borrador local no es un comprobante fiscal. Consulta el procedimiento oficial de SUNAT.
Acceso y consumo
Los cambios necesitan un emisor activo y un plan vigente. Se conserva el límite técnico de peticiones por clave y la auditoría. Estas operaciones laborales no descuentan el cupo de facturas, boletas y notas. Si desarrollas otro SaaS, sus límites por cliente deben aplicarse en tu propia integración.
