Facturas

Consultar, editar o crear facturas a clientes

Crear Factura

POST https://{clave}.admintotal.com/api/v2/movimientos/facturas/

Headers

NameTypeDescription

Api-key

string

Token de autenticación

Request Body

NameTypeDescription

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

{
    "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@empresa.com",
            "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}

AnteriorPedidosSiguienteProspectos

Última actualización