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

Name	Type	Description
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

Name	Type	Description
Api-key	string	Token de autenticación

Request Body

Name	Type	Description
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)

200

{
    "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": "[e-mail]",
            "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}