Clientes

Facturas

GET/clientes/:tkCliente/facturas

Permite obtener la lista de facturas asociadas al cliente.

Parámetros

Nombre	Tipo	Descripción
`tkCliente`	varchar	El código token que corresponde e identifica a un cliente en el sistema, del cual se requiere conocer las facturas asociadas.
`tkFactura`	varchar	Código token que identifica de forma única al recurso relacionado.
`pagina`	int	Número de página que se desea consultar.
`cantidadRegistros`	int	Cantidad máxima de registros que devuelve la consulta.

Respuesta

Nombre	Tipo	Descripción
`tkVenta`	UUID	Código token que corresponde a la venta.
`ejecutivo`	String	Contiene el nombre del ejecutivo que realizó la factura.
`iniciales`	String	Contiene las iniciales del nombre del ejecutivo que realizó la factura.
`razonEmisor`	String	El nombre de la razón social emisora.
`tkRazonEmisor`	UUID	Código token que corresponde a la razón social emisora.
`razonReceptor`	String	El nombre de la razón social receptora de la factura.
`tkReceptor`	UUID	Código token que corresponde a la razón social receptora.
`idMetodoPago`	Integer	Código que define el método de pago.
`metodoPago`	Integer	El nombre que corresponde al método de pago.
`idFormaPago`	Integer	Código que define la forma de pago.
`formaPago`	String	El nombre que corresponde al método de pago.
`serie`	String	Contiene el código o número de serie asociada a la factura.
`folio`	String	El folio que corresponde a la factura.
`tkFolio`	UUID	Código token que corresponde al folio utilizado en la factura.
`uuid`	UUID	Código proporcionado por el SAT cuando se timbra una factura.
`fechaTimbrado`	String	Fecha del timbrado de la factura por parte del SAT.
`fecha`	String	Contiene un formato compuesto de hora y fecha en la que se generó la factura.
`selloCfdi`	String	El sello correspondiente al CFDI.
`selloSat`	String	El sello emitido por parte del SAT.
`certificadoSat`	String	El certificado emitido por parte del SAT para la factura.
`timbrado`	String	El código emitido por el SAT para timbrar las facturas.
`timbradoError`	String	Mensaje en caso de que el timbrado haya fallado.
`tkArchivoPdf`	UUID	El token del archivo en PDF de la factura.
`tkArchivoXML`	UUID	El token del archivo en XML de la factura.
`status`	Integer	Indica el estado de la factura.
`adjuntar`	Integer	Verifica si los archivos relacionados a la cuenta seran adjuntados al correo.
`impuestosTrasladados`	Integer	Contiene un valor monetario que indica la cantidad de impuestos trasladados.
`impuestosRetenidos`	Integer	Contiene un valor monetario que indica la cantidad de impuestos retenidos.
`monto`	Float	Almacena una cantidad monetaria que indica el monto o subtotal de la factura.
`descuentos`	Integer	Almacena una cantidad monetaria que indica un descuento.
`timbradoErrorTxt`	String	Contiene el texto del error obtenido durante el proceso de timbrado de la factura.
`tipoComprobante`	String	Contiene un identificador que define el tipo de comprobante.
`tipoComprobanteTxt`	String	Almacena el nombre del tipo de comprobante.
`tkFactura`	UUID	Código token que identifica de forma única a una factura en el sistema.

Solicitud

curl --request GET 'https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/facturas?pagina=1&cantidadRegistros=1' \
  --header 'token: 00000000-0000-4000-8000-000000000001'const response=await fetch('https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/facturas?pagina=1&cantidadRegistros=1',{method:'GET',headers:{token:'00000000-0000-4000-8000-000000000001'}});
console.log(await response.json());const response=await fetch('https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/facturas?pagina=1&cantidadRegistros=1',{method:'GET',headers:{token:'00000000-0000-4000-8000-000000000001'}});
console.log(await response.json());import requests

response=requests.get('https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/facturas?pagina=1&cantidadRegistros=1',headers={'token':'00000000-0000-4000-8000-000000000001'})
print(response.json())package main

import("bytes";"fmt";"io";"net/http")
func main(){req,_:=http.NewRequest("GET","https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/facturas?pagina=1&cantidadRegistros=1",nil);req.Header.Set("token","00000000-0000-4000-8000-000000000001");res,_:=http.DefaultClient.Do(req);defer res.Body.Close();data,_:=io.ReadAll(res.Body);fmt.Println(string(data))}using System.Net.Http;using System.Text;using var client=new HttpClient();client.DefaultRequestHeaders.Add("token","00000000-0000-4000-8000-000000000001");using var content=null;var response=await client.GetAsync("https://api.upnify.com/v4/clientes/00000000-0000-4000-8000-000000000010/facturas?pagina=1&cantidadRegistros=1");Console.WriteLine(await response.Content.ReadAsStringAsync());

Respuesta

[
  {
    "tkVenta": "00000000-0000-4000-8000-000000000010",
    "ejecutivo": "valor-ejecutivo",
    "iniciales": "valor-iniciales",
    "razonEmisor": "valor-razonEmisor",
    "tkRazonEmisor": "00000000-0000-4000-8000-000000000010",
    "razonReceptor": "valor-razonReceptor",
    "tkReceptor": "00000000-0000-4000-8000-000000000010",
    "idMetodoPago": 0,
    "metodoPago": 0,
    "idFormaPago": 0,
    "formaPago": "valor-formaPago",
    "serie": "valor-serie",
    "folio": "valor-folio",
    "tkFolio": "00000000-0000-4000-8000-000000000010",
    "uuid": "00000000-0000-4000-8000-000000000010",
    "fechaTimbrado": "valor-fechaTimbrado",
    "fecha": "valor-fecha",
    "selloCfdi": "valor-selloCfdi",
    "selloSat": "valor-selloSat",
    "certificadoSat": "valor-certificadoSat",
    "timbrado": "valor-timbrado",
    "timbradoError": "valor-timbradoError",
    "tkArchivoPdf": "00000000-0000-4000-8000-000000000010",
    "tkArchivoXML": "00000000-0000-4000-8000-000000000010",
    "status": 0,
    "adjuntar": 0,
    "impuestosTrasladados": 0,
    "impuestosRetenidos": 0,
    "monto": "valor-monto",
    "descuentos": 0,
    "timbradoErrorTxt": "valor-timbradoErrorTxt",
    "tipoComprobante": "valor-tipoComprobante",
    "tipoComprobanteTxt": "valor-tipoComprobanteTxt",
    "tkFactura": "00000000-0000-4000-8000-000000000010"
  }
]

Facturas

Parámetros

Respuesta

Solicitud

Ejemplo de solicitud

Respuesta

Ejemplo de respuesta