API de Integracion
Documentacion para sincronizar Asientos de Diario (Journal Entries) de Nomina con sistemas externos.
1. Autenticacion
Obtenga un token JWT para autenticarse en todas las solicitudes.
2. Obtener Empresas
3. Plan de Cuentas
Consulte las cuentas contables para obtener los account_id necesarios.
4. Asientos de Diario (Journal Entries)
5. Cuentas Contables Tipicas de Nomina (RD)
| Codigo | Cuenta | Naturaleza | En el JE |
|---|---|---|---|
| 50152 | Sueldos y Salarios | Gasto | Debito |
| 60109 | TSS Patronal (Gasto) | Gasto | Debito |
| 25006 | ISR Retenido Nomina | Pasivo | Credito |
| 25010 | TSS por Pagar Empleado | Pasivo | Credito |
| 25011 | TSS por Pagar Patronal | Pasivo | Credito |
| 20201 | Sueldos por Pagar | Pasivo | Credito |
| 11001 | Banco (cuenta operativa) | Activo | Credito (al pagar) |
6. Errores Comunes
| Codigo | Mensaje | Causa |
|---|---|---|
| 400 | La entrada no esta balanceada | Total debitos distinto a total creditos |
| 400 | Una entrada debe tener al menos 2 lineas | Menos de 2 lineas |
| 400 | Fecha en periodo cerrado | Periodo contable cerrado |
| 401 | Token de autenticacion requerido | Falta header Authorization |
| 401 | Invalid token | Token expirado o invalido |
| 404 | Company not found | company_id invalido o sin acceso |
Flujo Recomendado para Sincronizacion
- 1
POST /api/auth/loginObtener token JWT - 2
GET /api/companiesObtener company_id - 3
GET /api/chart-of-accounts/{company_id}/accountsObtener account_ids del plan de cuentas - 4
POST /api/journal/{company_id}/entriesCrear JE de Nomina (entry_type: PAYROLL) - 5
POST /api/journal/{company_id}/entriesCrear JE de Pago (entry_type: PAYROLL_PAYMENT) - 6
GET /api/journal/{company_id}/entries?entry_type=PAYROLLVerificar asientos creados