Upnify API Docs
ERP · /suite/erp/buscar/empresas/facturacion

Buscar

Buscar empresas para facturación

GET/suite/erp/buscar/empresas/facturacion

Busca empresas disponibles para seleccionar un receptor de facturación por nombre comercial, razón social, RFC o concepto de oportunidad. El texto de búsqueda debe tener al menos 3 caracteres. La respuesta incluye el encabezado Row-Count con el total de resultados antes de aplicar la paginación.

Parámetros

NombreTipoValidaciónDescripción
buscarStringRequeridoTexto que se busca en el nombre comercial, razón social, RFC o concepto de oportunidad. Debe tener al menos 3 caracteres.
paginaIntegerNúmero de página que se consulta.
cantidadRegistrosIntegerCantidad máxima de empresas que se devuelve por página.

Respuesta

NombreTipoDescripción
tkProspectoStringIdentificador del prospecto asociado a la empresa.
correoStringCorreo electrónico registrado para el prospecto; devuelve una cadena vacía cuando no existe.
empresaStringNombre comercial de la empresa.
tkEmpresaStringIdentificador de la empresa.
razonSocialStringNombre fiscal de la razón social receptora.
tkRazonReceptorStringIdentificador de la razón social receptora.
idUsoCfdiIntegerCódigo del uso de CFDI configurado. Puede ser null.
rfcStringRFC de la razón social receptora.
metadataStringMetadatos registrados para la razón social. Puede ser null.
paisStringNombre del país de la razón social. Puede ser null.

Solicitud

Buscar empresas para facturar

curl --request GET \
  --url 'https://api.upnify.com/suite/erp/buscar/empresas/facturacion?buscar=cliente&pagina=1&cantidadRegistros=20' \
  --header 'token: 00000000-0000-4000-8000-000000000001'

Respuesta

Empresas para facturación encontradas

JSON
[
  {
    "tkProspecto": "00000000-0000-4000-8000-000000000030",
    "correo": "",
    "empresa": "Empresa Ejemplo",
    "tkEmpresa": "00000000-0000-4000-8000-000000000031",
    "razonSocial": "Empresa Ejemplo, S.A. de C.V.",
    "tkRazonReceptor": "00000000-0000-4000-8000-000000000032",
    "idUsoCfdi": 3,
    "rfc": "AAA010101AAA",
    "metadata": null,
    "pais": "México"
  }
]