Facturas

Consultar, editar o crear facturas a clientes

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

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}