Upnify API Docs
ERP · /suite/erp/buscar/no-relacionados

Buscar

Buscar ventas y facturas no relacionadas

GET/suite/erp/buscar/no-relacionados

Busca ventas y facturas que aún no están relacionadas con cuentas por cobrar ni movimientos bancarios. La consulta requiere la empresa y la razón social que se usarán como contexto; también puede filtrar por texto y por secciones. La respuesta incluye el encabezado Row-Count con el total de resultados antes de aplicar la paginación.

Parámetros

NombreTipoValidaciónDescripción
tkRazonSocialStringRequeridoIdentificador de la razón social emisora que se consulta.
tkCompaniaStringRequeridoIdentificador de la empresa que se usa para filtrar los resultados.
buscarStringTexto que se busca en los registros. Si se proporciona, debe tener al menos 3 caracteres; si se omite, se consultan todos los registros que cumplen los demás filtros.
seccionesStringSecciones que se consultan, separadas por comas. Los valores disponibles son ventas y facturas.
paginaIntegerNúmero de página que se consulta.
cantidadRegistrosIntegerCantidad máxima de registros que se devuelve por página.

Respuesta

NombreTipoDescripción
indiceIntegerPosición del registro dentro del resultado.
tkVentaStringIdentificador de la venta relacionada con el registro.
montoNumberMonto de la venta.
tkFacturaStringIdentificador de la factura relacionada. Puede ser null cuando el registro corresponde a una venta sin factura.
folioStringFolio de la factura; devuelve una cadena vacía cuando no aplica.
serieStringSerie de la factura; devuelve una cadena vacía cuando no aplica.
uuidStringUUID fiscal de la factura. Puede ser null cuando no existe una factura relacionada.
conceptoStringConcepto de la oportunidad o venta. Puede ser null.
rfcEmisorStringRFC de la razón social emisora. Puede ser null cuando no existe una factura relacionada.
razonEmisorStringRazón social emisora. Puede ser null cuando no existe una factura relacionada.
rfcReceptorStringRFC de la razón social receptora. Puede ser null cuando no existe una factura relacionada.
razonReceptorStringRazón social receptora. Puede ser null cuando no existe una factura relacionada.
ejecutivoNombreStringNombre del ejecutivo asociado a la venta.
empresaStringNombre comercial de la empresa.
tkMonedaStringIdentificador de la moneda de la venta. Puede ser null.
monedaIntegerCódigo interno de la moneda de la venta. Puede ser null.
tkCompaniaStringIdentificador de la empresa del registro.

Solicitud

Buscar registros no relacionados

curl --request GET \
  --url 'https://api.upnify.com/suite/erp/buscar/no-relacionados?tkRazonSocial=00000000-0000-4000-8000-000000000010&tkCompania=00000000-0000-4000-8000-000000000011&buscar=cliente&secciones=ventas%2Cfacturas&pagina=1&cantidadRegistros=20' \
  --header 'token: 00000000-0000-4000-8000-000000000001'

Respuesta

Registros no relacionados encontrados

JSON
[
  {
    "indice": 1,
    "tkVenta": "00000000-0000-4000-8000-000000000020",
    "monto": 1500.5,
    "tkFactura": "00000000-0000-4000-8000-000000000021",
    "folio": "1001",
    "serie": "A",
    "uuid": "00000000-0000-4000-8000-000000000022",
    "concepto": "Servicio de ejemplo",
    "rfcEmisor": "AAA010101AAA",
    "razonEmisor": "Emisor Ejemplo, S.A. de C.V.",
    "rfcReceptor": "BBB010101BBB",
    "razonReceptor": "Receptor Ejemplo, S.A. de C.V.",
    "ejecutivoNombre": "Usuario Ejemplo",
    "empresa": "Empresa Ejemplo",
    "tkMoneda": "00000000-0000-4000-8000-000000000023",
    "moneda": 1,
    "tkCompania": "00000000-0000-4000-8000-000000000011"
  }
]