developers
  • Introducción
  • API
    • v1
    • v2
      • Introducción
      • Autenticación
      • Almacenes
      • Clientes
      • Productos
      • Mensualidades
      • Lista negra
      • Contacto
      • Líneas
      • Sublíneas
      • Subsublíneas
      • Usuarios
      • Notas de venta
      • Pedidos
      • Facturas
      • Prospectos
      • Notas de crédito
      • Vehículos Entrega
      • Repartidores
      • Cotizaciones
      • Empleado
  • Webhooks
Con tecnología de GitBook
En esta página
  • Obtener listado de notas de venta
  • Crear nota de venta

¿Te fue útil?

  1. API
  2. v2

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

{
    "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).

AnteriorUsuariosSiguientePedidos

Última actualización hace 1 mes

¿Te fue útil?