Facturas
Consultar, editar o crear facturas a clientes
Endpoints disponibles
GET
https://{clave}.admintotal.com/api/v2/movimientos/facturas/
GET
https://{clave}.admintotal.com/api/v2/movimientos/facturas/{id}/
POST
https://{clave}.admintotal.com/api/v2/movimientos/facturas/
Obtener el listado de facturas
Obtiene el listado de facturas registradas. La consulta puede limitarse utilizando los parámetros de filtrado disponibles.
GET https://{clave}.admintotal.com/api/v2/movimientos/facturas/
Api-key
string
Token de autenticacion
cliente
integer
Filtro por identificador único del cliente.
—
cliente_razon_social
string
Filtro por razón social de cliente.
—
fecha
string
Filtro por fecha.
Formato: YYYY-MM-DD
desde
string
Filtro por fecha donde sea mayor o igual a este valor.
Formato: YYYY-MM-DD
hasta
string
Filtro por fecha donde sea menor o igual a este valor.
Formato: YYYY-MM-DD
uuid
string
Filtro por UUID.
—
folio
integer
Filtro por folio.
—
serie
string
Filtro por serie.
—
cancelado
integer
Filtro por movimiento cancelado.
0: Mostrará solo activos.
1: Mostrará solo cancelados.
centro_responsabilidad
integer
Filtro por identificador único del centro de responsabilidad.
—
}
"count": 722,
"next": "https://{clave}.admintotal.com/api/v2/clientes/",
"previous": null,
"results": [
{
"id": 4659569,
"status": 1,
"status_display": "Pendientes",
"almacen": 9,
"fecha": "2026-09-03",
"fecha_vencimiento": "2026-09-03",
"iva": "20.800000",
"subtotal": "130.00",
"total": "150.800000",
"uso_cfdi": "G01",
"comentarios": "",
"mostrar_comentarios": true,
"forma_pago": "01",
"detalles": [
{
"id": 5323921,
"factura": null,
"producto": 8355,
"cantidad": "1.0000",
"precio_unitario": "130.000000",
"importe": "130.000000",
"iva": "20.800000",
"ieps": "0.000000",
"entrega_domicilio": true
}
],
"creado": "2026-09-03T16:58:23.884366-07:00",
"xml_timbrado": "",
"cfdi_uuid": "",
"cfdi_status": "",
"cancelado": false,
"motivo_cancelacion": "",
"usuario_cancelacion": null,
"fecha_cancelacion": null,
"fecha_entrega": null,
"hora_entrega_a": null,
"hora_entrega_b": null,
"factura_pagada": "Sí",
"vendedor": "",
"saldo": "150.80",
"mensualidad": null,
"condicion": "Contado",
"poliza_texto": "",
"descuento": "0.00",
"moneda": "MXN",
"direccion_entrega": {
"id": 32980,
"municipio": "Hermosillo",
"localidad": "Hermosillo",
"estado": "Sonora",
"calle": "Articulo 123",
"colonia": "Misión del sol",
"cp": "83100",
"telefono": "",
"email": "",
"numero_e": "93A",
"numero_i": "",
"pais_residencia": "MEX",
"latitud": null,
"longitud": null,
"referencia": ""
},
"folio": 208,
"folio_completo": "F208",
"centro_responsabilidad": {
"id": 4,
"numero": "3",
"nombre": "TERCERO"
},
"url_pdf": "http://{clave}.admintotal.com/admin/pdf_salida/4659569/",
"cliente": {
"id": 1850,
"activo": true,
"tipo_cliente": 2,
"razon_social": "Empresa cliente",
"codigo": "",
"referencia": "",
"nombre_comercial": "",
"sitio_web": "",
"rfc": "HHH140305BI0",
"curp": "",
"limite_credito": "0.00",
"representante_legal": "",
"direccion": {
"id": 24827,
"municipio": "Hermosillo, Hermosillo",
"localidad": "",
"estado": "Sonora",
"calle": "Blvd Antonio Quiroga",
"colonia": "Real de Quiroga",
"cp": "83224",
"telefono": "",
"email": "email@empresa.com",
"numero_e": "142",
"numero_i": "",
"pais_residencia": "",
"latitud": "0.00000000",
"longitud": "0.00000000",
"referencia": null
},
"bloquear_vencido": true,
"dias_cortar_credito": 0,
"dias_credito": 0,
"regimen_fiscal": "616",
"creado": "2023-01-31T11:06:18.440186-07:00",
"usuario_creado": 23,
"direccion_txt": "Blvd Antonio Quiroga 142 C.P. 83224 Hermosillo, Sonora.",
"almacen_precios": {
"id": 9,
"codigo": "001",
"nombre": "001 Matriz"
},
"clasificacion": null,
"segmentacion": null
},
"metodo_pago": 0
},
...
]
}Campos principales facturas
id
integer
Identificador único de la factura creada.
—
status
integer
Identificador numérico del estado actual de la factura.
—
status_display
string
Descripción legible del estado actual de la factura.
—
almacen
integer
Identificador del almacén asociado a la factura.
—
fecha
string
Fecha de la factura.
Formato: YYYY-MM-DD
fecha_vencimiento
string
Fecha de vencimiento de la factura.
Formato: YYYY-MM-DD
iva
decimal
Importe total correspondiente al IVA.
—
subtotal
decimal
Importe de la factura antes de impuestos.
—
total
decimal
Importe total de la factura.
—
uso_cfdi
string
Clave de uso del CFDI asignada a la factura.
—
comentarios
string
Comentarios asociados a la factura.
—
mostrar_comentarios
boolean
Configurar si se desea mostrar los comentarios ingresados en la factura.
—
forma_pago
string
Clave SAT correspondiente a la forma de pago. Si no se especifica, se intentará utilizar la configurada en el cliente.
—
detalles
array
Productos incluidos en la factura.
—
creado
datetime
Fecha y hora en que se creó el registro.
Formato: YYYY-MM-DDTHH:mm:ss±hh:mm
xml_timbrado
string
Timbre Fiscal Digital autorizado y validado por el SAT.
—
cfdi_uuid
string
UUID del xml de la factura.
—
cfdi_status
string
Guarda el mensaje de error arrojado al intentar timbrar.
—
cancelado
boolean
Saber si la factura se encuentra cancelada o no.
—
motivo_cancelacion
string
Motivo por el cual la factura fue cancelada.
—
usuario_cancelacion
integer
Identificador numérico del usuario que canceló la factura.
—
fecha_cancelacion
string
Fecha de cancelación de la factura.
Formato: YYYY-MM-DD
fecha_entrega
string
Fecha de entrega de la factura.
Formato: YYYY-MM-DD
hora_entrega_a
string
Hora de inicio de la entrega.
Formato: HH:MM AM/PM
hora_entrega_b
string
Hora de fin de la entrega.
Formato: HH:MM AM/PM
factura_pagada
string
Indicador de la factura se encuentra pagada.
—
vendedor
string
Nombre del vendedor de la factura.
—
saldo
decimal
Total neto de la factura.
—
mensualidad
integer
Identificador numérico de la mensualidad asociada a la factura.
—
condicion
string
Plazo para la liquidación de la factura.
—
poliza_texto
string
Número de Póliza.
—
descuento
decimal
Descuento aplicado para la factura.
—
moneda
string
Moneda en la que se expresan los importes de la factura.
—
direccion_entrega
object
Dirección de entrega asociada a la factura.
—
folio
integer
Número de folio asignado a la factura.
—
folio_completo
string
Folio de la factura con el formato utilizado por el sistema.
—
centro_responsabilidad
object
Centro de responsabilidad ligado a la factura.
—
url_pdf
string
URL del PDF de la factura.
—
cliente
object
Información del cliente asociado a la factura.
—
metodo_pago
string
Método de pago del CFDI.
Valores permitidos: PPD o PUE. Si no se especifica, se intentará utilizar el configurado en el cliente.
—
Obtener una factura
Obtiene la información detallada de un cliente específico.
GET https://{clave}.admintotal.com/api/v2/movimientos/facturas/{id}/
Api-key
string
Token de autenticación.
Campos adicionales disponibles al consultar una factura individual
movimiento_origen
string
Describe desde que parte del sistema fue creada la factura.
movimientos_relacionados
array
Muestra los documentos relacionados a la factura.
campos_personalizados
array
Campos personalizados.
Crear Factura
Crea una nueva factura asociada a un cliente.
POST https://{clave}.admintotal.com/api/v2/movimientos/facturas/
Request Body
Api-key
string
Token de autenticación.
fecha
string
No
Fecha de la factura. Formato: YYYY-MM-DD
cliente
integer
Si
Identificador único del cliente.
Puede utilizarse cuando no se envía cliente_rfc.
almacen
integer
No
Identificador único del almacén. Si no se especifica, se utilizará el primer almacén.
direccion_entrega
object
No
Información de la dirección en la que se realizará la entrega.
comentarios
string
No
Comentarios u observaciones asociados a la factura.
detalles
array
Si
Lista de productos que conforman la factura. (Para especificar el producto puede ser por producto, producto_codigo o producto_codigo_proveedor)
vendedor
integer
No
Identificador único del empleado que será asignado como vendedor de la factura.
mostrar_comentarios
boolean
No
Indica si los comentarios de la factura deben mostrarse.
campos_personalizados
array
No
Lista de campos personalizados.
cliente_rfc
string
No
RFC del cliente. Puede utilizarse para identificar al cliente cuando no se envía cliente.
cliente_cp
string
No
Código postal del cliente.
cliente_regimen_fiscal
string
No
Régimen fiscal del cliente.
uso_cfdi
string
No
Clave del Uso de CFDI asignado a la factura, conforme al catálogo del SAT.
codigo_cliente
string
No
Código asignado al cliente.
codigo_almacen
string
No
Código asignado al almacén.
carta_porte
object
No
Información requerida para generar el complemento Carta Porte.
forma_pago
string
No
Clave SAT correspondiente a la forma de pago. Si no se especifica, se intentará utilizar la configurada en el cliente.
nombre_direccion_entrega
string
No
Nombre asignada a la dirección de entrega.
Respuesta 201 Created
Obtener PDF's de facturas
Para consultar el PDF de una factura podemos usar la URL que se retorna en la propiedad url_pdf del objeto de factura agregando adicional el parámetro GET access_token ó api_key dependiendo el caso, ejemplo:
Ejemplo de la URL si se tiene un token JWT
https://{clave}.admintotal.com/api/v2/movimientos/facturas/?access_token={mi_access_token}
Ejemplo de la URL si se tiene un api key
https://{clave}.admintotal.com/api/v2/movimientos/facturas/?api_key={api_key}
Errores HTTP
Posibles códigos de error que puedes encontrar al consumir este recurso.
Última actualización