GuíaEjemplosReferencia API
apisunat.netIngresar

Consultas SUNAT

  • POSTBuscar contribuyentes por DNI
  • POSTBuscar por nombres, apellidos o razón social
  • POSTConsultar ficha pública por RUC

Laboral

  • GETListar Trabajadores
  • POSTCrear Trabajadores
  • PUTEditar Trabajadores
  • GETListar Planillas
  • POSTCrear Planillas
  • PUTEditar Planillas
  • GETListar Honorarios
  • POSTCrear Honorarios
  • PUTEditar Honorarios
  • POSTCambiar estado de planilla
  • POSTRegistrar pago de honorarios
  • POSTAnular registro local de honorarios
  • GETRegímenes laborales

Cuenta

  • GETComprobar la clave
  • GETPlan y consumo del mes

Emisores

  • GETListar RUC
  • POSTRegistrar un RUC
  • GETConsultar un RUC
  • PATCHActivar o desactivar un RUC
  • PUTGuardar credenciales SUNAT
  • POSTValidar el RUC con SUNAT
  • POSTPasar el RUC a producción

Series y establecimientos

  • GETListar series
  • GETListar establecimientos
  • POSTCrear o actualizar un establecimiento

Utilidades

  • POSTCalcular totales e IGV
  • GETListar catálogos SUNAT
  • GETBuscar en el catálogo 25 (productos SUNAT)
  • GETConsultar un catálogo

Documentos

  • GETListar documentos
  • POSTEmitir factura, boleta, nota o retención
  • GETConsultar un documento
  • GETDescargar PDF, XML, ZIP o CDR
  • POSTReenviar a SUNAT
  • POSTConsultar el ticket en SUNAT
  • GETHistorial de correos
  • POSTEnviar por correo
  • POSTReintentar un correo

Anulaciones

  • POSTAnular documentos
  • GETConsultar una anulación

GRE

  • POSTEmitir una guía de remisión (GRE)
  • GETConsultar una guía

Recursos

  • GETEspecificación OpenAPI
  • GETColección Postman
  • GETResumen para asistentes de IA
POST/issuer/issuers/{ruc}/payroll/receipts

Crear Honorarios

Send request

Use the documented inputs to call this endpoint directly.

API serverbase URL
Bearer tokenBearerAuthoptional
Stored only in this browser for the BearerAuth security scheme and reused on every API page in this group.

Parameters

Values are applied to the request and the example on the right.

rucpath · stringrequired

Request body

application/jsonrequired
customerDocumentNumberstringrequired
customerDocumentTypeenumrequired

Values: "RUC" · "DNI" · "CE"

customerNamestringrequired
directionenumrequired

Values: "issued" · "received"

dueDatestringrequired
grossCentsnumberrequired
issueDatestringrequired
notesstringrequired
numberstringrequired
paymentTermsenumrequired

Values: "cash" · "credit"

professionalNamestringrequired
professionalRucstringrequired
registeredbooleanrequired
seriesstringrequired
servicestringrequired
suspensionNumberstringrequired
suspensionYearobjectrequired
withholdingAgentbooleanrequired

Responses

200application/json

Correcto.

{
  "balanceGrossCents": 1.5,
  "customerDocumentNumber": "string",
  "customerDocumentType": "RUC",
  "customerName": "string",
  "direction": "issued",
  "dueDate": "string",
  "grossCents": 1.5,
  "id": "",
  "issueDate": "string",
  "netCents": 1.5,
  "notes": "string",
  "number": "string",
  "paidCents": 1.5,
  "paidGrossCents": 1.5,
  "paymentTerms": "cash",
  "payments": [
    {
      "amountCents": 1.5,
      "date": "string",
      "grossCents": 1.5,
      "id": "",
      "reference": "string",
      "suspensionNumber": "string",
      "suspensionYear": "string",
      "withholdingAgent": true,
      "withholdingCents": 1.5
    }
  ],
  "professionalName": "string",
  "professionalRuc": "string",
  "registered": true,
  "revision": 1.5,
  "series": "string",
  "service": "string",
  "status": "draft",
  "suspensionNumber": "string",
  "suspensionYear": "string",
  "withheldPaidCents": 1.5,
  "withholdingAgent": true,
  "withholdingCents": 1.5
}
balanceGrossCentsnumberrequired
customerDocumentNumberstringrequired
customerDocumentTypeenumrequired

Values: "RUC" · "DNI" · "CE"

customerNamestringrequired
directionenumrequired

Values: "issued" · "received"

dueDatestringrequired
grossCentsnumberrequired
idstringrequired
issueDatestringrequired
netCentsnumberrequired
notesstringrequired
numberstringrequired
paidCentsnumberrequired
paidGrossCentsnumberrequired
paymentTermsenumrequired

Values: "cash" · "credit"

paymentsarray<>required
professionalNamestringrequired
professionalRucstringrequired
registeredbooleanrequired
revisionnumberrequired
seriesstringrequired
servicestringrequired
statusenumrequired

Values: "draft" · "registered" · "void"

suspensionNumberstringrequired
suspensionYearobjectrequired
withheldPaidCentsnumberrequired
withholdingAgentbooleanrequired
withholdingCentsnumberrequired
400application/json

VALIDATION_ERROR: El cuerpo, los parámetros o una regla del comprobante no son válidos. fields indica el campo.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}
errorrequired
401application/json

UNAUTHENTICATED: Falta la clave API o no es válida.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}
errorrequired
402application/json

TRIAL_EXPIRED: La prueba gratuita venció.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}
errorrequired
403application/json

WORKSPACE_SUSPENDED: El workspace está suspendido.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}
errorrequired
429application/json

RATE_LIMITED: Se superó el límite de peticiones. Respeta el header Retry-After.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}
errorrequired
500application/json

INTERNAL_ERROR: Error interno. Reintenta y comparte el requestId con soporte.

{
  "error": {
    "code": "string",
    "fields": {},
    "message": "string",
    "requestId": "",
    "retryable": true
  }
}
errorrequired
Listar Honorarios< PreviousEditar HonorariosNext >

Powered by heyo

curl --request POST \
  'https://api.apisunat.net/api/v1/issuer/issuers/string/payroll/receipts' \
  --header 'Content-Type: application/json' \
  --data '{
  "customerDocumentNumber": "string",
  "customerDocumentType": "RUC",
  "customerName": "string",
  "direction": "issued",
  "dueDate": "string",
  "grossCents": 1.5,
  "issueDate": "string",
  "notes": "string",
  "number": "string",
  "paymentTerms": "cash",
  "professionalName": "string",
  "professionalRuc": "string",
  "registered": true,
  "series": "string",
  "service": "string",
  "suspensionNumber": "string",
  "suspensionYear": "string",
  "withholdingAgent": true
}'
{
  "balanceGrossCents": 1.5,
  "customerDocumentNumber": "string",
  "customerDocumentType": "RUC",
  "customerName": "string",
  "direction": "issued",
  "dueDate": "string",
  "grossCents": 1.5,
  "id": "",
  "issueDate": "string",
  "netCents": 1.5,
  "notes": "string",
  "number": "string",
  "paidCents": 1.5,
  "paidGrossCents": 1.5,
  "paymentTerms": "cash",
  "payments": [
    {
      "amountCents": 1.5,
      "date": "string",
      "grossCents": 1.5,
      "id": "",
      "reference": "string",
      "suspensionNumber": "string",
      "suspensionYear": "string",
      "withholdingAgent": true,
      "withholdingCents": 1.5
    }
  ],
  "professionalName": "string",
  "professionalRuc": "string",
  "registered": true,
  "revision": 1.5,
  "series": "string",
  "service": "string",
  "status": "draft",
  "suspensionNumber": "string",
  "suspensionYear": "string",
  "withheldPaidCents": 1.5,
  "withholdingAgent": true,
  "withholdingCents": 1.5
}