Facturas
Consultar, editar o crear facturas a clientes
Obtener el listado de facturas
GET
https://{clave}.admintotal.com/api/v2/movimientos/facturas/
Parámetros GET disponibles
cliente
integer
Filtro por ID de 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
int
Filtro por movimiento cancelado: 0 = Mostrará solo activos 1 = Mostrará solo cancelados
Crear Factura
POST
https://{clave}.admintotal.com/api/v2/movimientos/facturas/
Headers
Api-key
string
Token de autenticación
Request Body
detalles
array
Lista de objetos con la información de los productos de la factura (para especificar el producto puede ser por producto, producto_codigo o producto_codigo_proveedor), ejemplo:
[
{
"producto": 3131,
"cantidad": 1,
"um": {
"nombre": "Caja",
"factor": 12
},
"precio_unitario": "30.00",
"descripcion_adicional": "Concepto diferente para esta partida"
}
]
direccion_entrega
object
Objeto con la información de dirección de entrega, ejemplo:
{
"nombre": "Ejemplo 1",
"direccion": {
"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": ""
}
}
comentarios
string
Comentarios sobre el pedido
fecha
string
Fecha del pedido en formato YYYY-MM-DD
almacen
integer
ID del almacén (en caso de no especificar se tomará el primer almacén)
cliente_rfc
string
RFC del cliente (este parámetro es opcional si se especifica cliente)
cliente
integer
ID de cliente (este parámetro es opcional si se especifica cliente_rfc)
vendedor
integer
ID de empleado para asignarlo como vendedor a la factura
metodo_pago
string
Valores permitidos: PPD o PUE (si no se especifica se intentará tomar del cliente)
forma_pago
string
Posibles valores: "01", "02", "03", "04", "05", "06", "08", "12", "13", "14", "15", "17", "23", "24", "25", "26", "27", "28", "29", "30", "31", "99" (si no se especifica se intentará tomar del cliente)
{
"id": 755484,
"status": 1,
"almacen": 9,
"fecha": "2021-03-03",
"iva": "105.600000",
"subtotal": "660.00",
"total": "765.600000",
"comentarios": "",
"detalles": [
{
"id": 3536050,
"producto": 125072,
"cantidad": "3.0000",
"precio_unitario": "220.0000",
"importe": "660.000000",
"iva": "105.600000"
}
],
"creado": "2021-02-02T11:00:41.741114-07:00",
"status_display": "Pendientes",
"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": 25148,
"folio_completo": "025148",
"cliente": {
"id": 3628,
"activo": true,
"tipo_cliente": 1,
"razon_social": "Empresa cliente",
"codigo": "",
"referencia": null,
"nombre_comercial": "",
"sitio_web": "",
"rfc": "HHH140305BI0",
"curp": "",
"limite_credito": "0.00",
"representante_legal": "",
"direccion": {
"id": 24827,
"municipio": "Hermosillo, Hermosillo",
"localidad": "",
"estado": "Estado de México",
"calle": "Blvd Antonio Quiroga",
"colonia": "Real de Quiroga",
"cp": "83224",
"telefono": "",
"email": "[email protected]",
"numero_e": "142",
"numero_i": "",
"pais_residencia": "",
"latitud": "0.00000000",
"longitud": "0.00000000",
"referencia": null
},
"saldo_pendiente": "0",
"dias_credito": 0
},
"uso_cfdi": "P01"
}
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}
Última actualización