GuíaEjemplosReferencia API
apisunat.netIngresar

Primeros pasos

  • API SUNAT
  • Inicio rápido
  • Integra con IA
  • Servidor MCP
  • n8n
  • Autenticación
  • Planes y límites
  • Planillas y honorarios

Configurar el RUC

  • Emisores
  • Establecimientos y series

Emitir

  • Documentos
  • Idempotencia
  • Estados
  • Correos
  • Catálogos

Integración

  • Errores
  • Webhooks
  • Cambios

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:

text
https://api.apisunat.net/api/v1/issuer/issuers/{ruc}/payroll

El RUC debe pertenecer a tu workspace y al modo de la clave. asu_test_ y asu_live_ tienen datos independientes.

Rutas disponibles

MétodoRuta relativaOperación
GET/regimesPolíticas y regímenes laborales
GET / POST/employeesListar o crear trabajadores
PUT/employees/{id}Actualizar un trabajador
GET / POST/runsListar o calcular una planilla en borrador
PUT/runs/{id}Recalcular un borrador
POST/runs/{id}/statusAprobar, registrar pago o anular localmente
GET / POST/receiptsListar o registrar honorarios
PUT/receipts/{id}Editar un borrador de honorarios
POST/receipts/{id}/paymentsRegistrar un pago realizado
POST/receipts/{id}/voidAnular 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

bash
curl -X POST 'https://api.apisunat.net/api/v1/issuer/issuers/20123456789/payroll/employees' \
  -H "X-API-Key: $APISUNAT_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"name":"Persona de prueba","documentType":"DNI","documentNumber":"12345678","position":"Analista","hireDate":"2026-01-01","salaryCents":200000,"pensionSystem":"onp","laborRegime":"general","healthSystem":"essalud","regimeReference":"","active":true}'

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.

Planes y límites< PreviousEmisoresNext >

Powered by heyo

On this page

Rutas disponiblesCrear un trabajadorEstados y pagosQué significa registrar honorariosAcceso y consumo