Notas de venta

Obtener listado de notas de venta

GET https://{clave}.admintotal.com/api/v2/movimientos/notas_venta/

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)
folio	integer	Filtro por folio
serie	string	Filtro por serie
cancelado	int	Filtro por movimiento cancelado: 0 = Mostrará solo activos 1 = Mostrará solo cancelados

200

{
    "count": 731,
    "next": "https://{clave}.admintotal.com/api/v2/movimientos/notas_venta/",
    "previous": null,
    "results": [
        {
            "id": 25320,
            "status": 1,
            "almacen": 1545,
            "fecha": "2021-11-09",
            "fecha_vencimiento": "2021-11-09",
            "iva": "33.103448",
            "subtotal": "206.90",
            "total": "240.000000",
            "uso_cfdi": "P01",
            "comentarios": "",
            "mostrar_comentarios": true,
            "forma_pago": 0,
            "detalles": [
                {
                    "id": 91874,
                    "producto": 11077,
                    "cantidad": "1.0000",
                    "precio_unitario": "206.8966",
                    "importe": "206.896552",
                    "iva": "33.103448"
                }
            ],
            "creado": "2021-11-09T10:40:50.974804-07:00",
            "xml_timbrado": "",
            "cancelado": false,
            "motivo_cancelacion": "",
            "usuario_cancelacion": null,
            "fecha_cancelacion": null,
            "metodo_pago": "28",
            "monto_efectivo": "0.0000",
            "monto_tarjeta": "0.0000",
            "monto_transferencia": "0.0000",
            "monto_cheque": "0.0000",
            "status_display": "Pendientes",
            "direccion_entrega": {
                "id": 3283,
                "municipio": "",
                "localidad": "",
                "estado": "",
                "calle": ".",
                "colonia": "",
                "cp": "",
                "telefono": "",
                "email": "",
                "numero_e": "",
                "numero_i": "",
                "pais_residencia": "",
                "latitud": "0.00000000",
                "longitud": "0.00000000",
                "referencia": ""
            },
            "folio": 606,
            "folio_completo": "606",
            "url_pdf": "https://{clave}.admintotal.com/admin/pdf_nota_venta/25320/",
            "cliente": {
                "id": 1522,
                "activo": true,
                "tipo_cliente": 1,
                "razon_social": "PUBLICO EN GENERAL",
                "codigo": "",
                "referencia": "",
                "nombre_comercial": "",
                "sitio_web": "",
                "rfc": "XAXX010101000",
                "curp": "",
                "limite_credito": "10000000.00",
                "representante_legal": "",
                "direccion": {
                    "id": 3283,
                    "municipio": "",
                    "localidad": "",
                    "estado": "",
                    "calle": ".",
                    "colonia": "",
                    "cp": "",
                    "telefono": "",
                    "email": "",
                    "numero_e": "",
                    "numero_i": "",
                    "pais_residencia": "",
                    "latitud": "0.00000000",
                    "longitud": "0.00000000",
                    "referencia": ""
                },
                "bloquear_vencido": false,
                "dias_cortar_credito": 10,
                "saldo_pendiente": "1796182.8100",
                "dias_credito": 10
            }
        }
    ]
}

Crear nota de venta

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

Para habilitar la auto-facturación de los clientes, es necesario especificar un valores en las propiedades "id_externo" y "clave_autofacturacion

Headers

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

Request Body

Name	Type	Description
numero_tarjeta	integer	Últimos 4 digitos de la tarjeta
tipo_tarjeta	integer	1: crédito 2: débito
monto_tarjeta	number	Monto de tarjeta
monto_efectivo	number	Monto de efectivo
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" } ]
direccion_entgrega	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 la nota de venta
fecha	string	Fecha en formato ISO 8601
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)
id_externo	string	Identificador externo para esta nota de venta (ejemplo: puede ser el folio del sistema externo que genera esta nota de venta)
clave_facturacion	string	Clave de facturación (6 caracteres recomendado), esta clave la necesita el cliente para auto-facturarse en el portal de facturación (también necesita el id_externo).
campos_personalizados	array	Lista de campos personalizados (se validarán los campos personalizados de venta), ejemplo de estructura: [ { "key": "codigo_reservacion", "valor": "FKL4646" }, { "key": "origen", "valor": "Sistema externo" } ]
moneda	string	(Opcional) nombre de la moneda de la nota de venta
tipo_cambio	string	(Opcional) tipo de cambio

200