GET/clientes/facturacion
Permite obtener la lista de las facturas.
Rutas alternativas
/reportes/clientesfacturas
Parámetros
| Nombre | Tipo | Validación | Descripción |
|---|
periodo | int | | Permite filtrar los registros por fecha de creación. |
fechaInicio | varchar | | Permite filtrar los registros a partir de esta fecha. |
fechaFin | varchar | | Permite filtrar los registros hasta esta fecha. |
tkUsuario | varchar | | Código token del ejecutivo a filtrar. |
tkGrupo | varchar | | Código token que corresponde a un grupo de usuarios a filtrar. |
tkMoneda | varchar | | Código token que corresponde e identifica a un tipo de moneda registrado en el sistema. |
tkEmisor | varchar | | Código token que identifica de forma única a un emisor al cual se quiere filtrar. |
receptor | varchar | | Indica el receptor a filtrar. |
concepto | varchar | | Indica el concepto a filtrar. |
metodoPago | varchar | | Valor de metodoPago utilizado por la operación. |
tipo | varchar | | Tipo de operación solicitada. |
orden | varchar | | Criterio de ordenamiento de los resultados. |
status | varchar | | Estado de aprobación que se desea aplicar. |
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 |
|---|
idFactura | Integer | Identificador de la factura. |
prospecto | String | Nombre de la persona a nombre de la factura. |
empresa | String | Nombre de la empresa. |
esCliente | Integer | Indica si la empresa es cliente. |
razonEmisor | String | Contiene el nombre de la razón social emisora. |
razonReceptor | String | Contiene la razón del receptor de la factura. |
concepto | String | Contiene el concepto de la factura |
fechaTimbre | Datetime | Fecha del timbrado de la factura por parte del SAT. |
fecha | Datetime | Contiene un formato compuesto de hora y fecha en la que se generó la factura. |
ejecutivo | String | Contiene el nombre completo del ejecutivo. |
iniciales | String | Contiene las iniciales del ejecutivo. |
monto | Float | Guarda un valor numérico que representa un monto monetario. |
serie | String | Indica el nombre de la serie de folios. |
folio | String | Contiene el número del folio utilizado. |
descuento | Float | Contiene un monto que representa un descuento aplicado a una oportunidad. |
uuid | UUID | Código proporcionado por el SAT cuando se timbra una factura. |
status | Integer | Indica el estado de la factura. |
statusText | String | Contiene la descripción del estado. |
porcentajeVenta | Float | Porcentaje de la venta cubierta en la factura. |
impuestosTraslados | Float | Cantidad monetaria de los impuestos trasladados. |
impuestosRetenidos | Float | Cantidad monetaria de los impuestos retenidos. |
total | Float | Contiene una cantidad monetaria que indica un monto que corresponde a la suma del total y los impuestos. |
moneda | String | Contiene un código que indica el tipo de moneda elegida para la venta. |
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. |
tkUsuario | UUID | Código token del usuario o ejecutivo que utiliza la cuenta. |
tkVenta | UUID | Código token que corresponde a la venta. |
tkProspecto | UUID | Código token que identifica y corresponde a un prospecto. |
tkEmpresa | UUID | Código token de la empresa a la que pertenece la cuenta. |
cancelarFactura | Integer | Inidica si la factura se ha cancelado. |
peso | Integer | Indica el peso o tamaño del archivo. |
Solicitud
curl --request GET 'https://api.upnify.com/v4/clientes/facturacion?orden=&pagina=1&cantidadRegistros=1' \
--header 'token: 00000000-0000-4000-8000-000000000001'const response=await fetch('https://api.upnify.com/v4/clientes/facturacion?orden=&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/facturacion?orden=&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/facturacion?orden=&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/facturacion?orden=&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/facturacion?orden=&pagina=1&cantidadRegistros=1");Console.WriteLine(await response.Content.ReadAsStringAsync());
Respuesta
[
{
"idFactura": 0,
"prospecto": "valor-prospecto",
"empresa": "valor-empresa",
"esCliente": 0,
"razonEmisor": "valor-razonEmisor",
"razonReceptor": "valor-razonReceptor",
"concepto": "valor-concepto",
"fechaTimbre": "valor-fechaTimbre",
"fecha": "valor-fecha",
"ejecutivo": "valor-ejecutivo",
"iniciales": "valor-iniciales",
"monto": "valor-monto",
"serie": "valor-serie",
"folio": "valor-folio",
"descuento": "valor-descuento",
"uuid": "00000000-0000-4000-8000-000000000010",
"status": 0,
"statusText": "valor-statusText",
"porcentajeVenta": "valor-porcentajeVenta",
"impuestosTraslados": "valor-impuestosTraslados",
"impuestosRetenidos": "valor-impuestosRetenidos",
"total": "valor-total",
"moneda": "valor-moneda",
"tipoComprobante": "valor-tipoComprobante",
"tipoComprobanteTxt": "valor-tipoComprobanteTxt",
"tkFactura": "00000000-0000-4000-8000-000000000010",
"tkUsuario": "00000000-0000-4000-8000-000000000010",
"tkVenta": "00000000-0000-4000-8000-000000000010",
"tkProspecto": "00000000-0000-4000-8000-000000000010",
"tkEmpresa": "00000000-0000-4000-8000-000000000010",
"cancelarFactura": 0,
"peso": 0
}
]
