Skip to main content
GET
GET /v1/de/search
Devuelve documentos elegibles para ser referenciados en una Nota de Crédito o Nota de Débito. Filtra automáticamente:
  • Solo DE en estado A (aprobados).
  • Solo tipos 1 (factura) o 4 (autofactura).
El parámetro tipo_nota determina si además se filtra por saldo disponible:

Cuándo usarlo

  • Wizard de emisión de NC/ND: combobox con búsqueda donde el usuario elige la factura original a anular/ajustar/recargar.
  • Validación previa: confirmar que un CDC que viene de tu sistema es acreditable antes de emitir la NC/ND.
El parámetro q filtra por nombre del cliente, RUC o número del DE (mínimo 3 caracteres). Cada item del response incluye el CDC del DE original que después usás en el objeto doc_asociado al emitir la NC o ND.

Authorizations

Authorization
string
header
required

Query Parameters

q
string
required

Término de búsqueda sobre nombre del cliente, RUC o número. Mínimo 3 chars. Devuelve hasta 10 DEs aprobados (Factura o Autofactura) para referenciar en una NC/ND.

Required string length: 3 - 120
tipo_nota
integer
default:5

Tipo de nota a emitir: 5 (Nota de Crédito, default) filtra solo DEs con saldo acreditable > 0; 6 (Nota de Débito) devuelve todas las facturas/autofacturas aprobadas sin filtro de saldo, ya que un débito no consume saldo.

Response

Successful Response

The response is of type Return · object.