API : Ventas

https://www.obuma.cl/ayuda/articulo/160/api--ventas

Endpoints para tarabajar con Dctos de Ventas / Dctos Tributarios :

 

 

Ventas > DTE/Notas de Venta :

 

  •  GET   /ventas.list.json    

Devuelve lista con todos los documentos de ventas de la empresa. Incluyendo notas de venta.

 

--- Parametros : opcionales

id : es el id del dcto de venta

tipo_dcto : es el codigo del tipo dcto segun tabla del SII.

folio_dcto : es el folio del documento.

permite pasar operadores de comparacion en la variable : > >= < <= !=

el operador se debe enviar despues de la variable Ejemplo folio_dcto=<100

 

mes : es el mes de emision del dcto.  Ej. 02

ano : es el año de emision del dcto. Ej. 2018

fecha : fecha del dcto en cualquier formato dd-mm-yyyy ó yyyy-mm-dd

 

total : es el monto total de la venta.

permite pasar operadores de comparacion en la variable : > >= < <= !=

 

total_pagado : es el monto total pagado del dcto.

permite pasar operadores de comparacion en la variable : > >= < <= !=

 

total_por_pagar : es el monto total por pagar del dcto.

permite pasar operadores de comparacion en la variable : > >= < <= !=

cliente : el id del cliente asociado a la venta.

cliente_rut : el el rut exacto del cliente. (con puntos y guion)

 

sucursal : es el id de la  sucursal asociada a la venta.

bodega : es el id de la bodega asociada a la venta.

usuario : es el id usuario que emite el dcto.

vendedor : es el id del vendedor asociado al dcto.

 

 

  •  GET  /ventas.findById.json/ID    

Devuelve una venta en especifico.

 

--- Parametros :

ID : Es el id de la venta.

 

 

  •  GET  /ventas.listItems.json   

Devuelve un listado de todos los items de las ventas, es un listado de ventas item por item.

 

--- Parametros : opcionales

Todos los de ventas + 

producto_id : es el id del producto

producto_sku : es el codigo comercial o codigo sku del producto

 

 

 

  •  GET  /ventas.listReferencias.json   

Devuelve un listado de todas las referencias de las ventas.

 

--- Parametros : opcionales

Todos los de ventas + 

tipo_dcto_ref : tipo dcto de la referencia

folio_dcto_ref : folio dcto de la referencia

fecha_dcto_ref : fecha del dcto de la referencia

 

 

 

  •  GET   /ventas.listLast.json   

Devuelve el ultimo folio usado en obuma para un tipo dcto 

 

--- Parametros : 

tipo_dcto : el codigo tipo dcto

 

 

  •  GET   /ventas.listOne.json   

Devuelve un completo array de un dcto a partir del id

 

--- Parametros : 

id_venta : el id de la venta

 

--- Resultado :

{
"data-actual-total": 1,
"data-actual-limit": 100,
"data-actual-page": 1,
"data-total-items": null,
"data-total-pages": null,
"data": [
  {
"doc_id": "2943058",
"doc_tipo": "33",
"doc_tipo_nombre": "FACTURA ELECTRONICA",
"doc_folio": "10519",
"doc_fecha_ingreso": "",
"doc_hora_ingreso": "",
"doc_fecha_emision": "01-02-2022",
"doc_fecha_vencimiento": "16-02-2022",
"doc_dias_validez": 15,
"doc_fecha_entrega": "",
"doc_hora_entrega": "",
"doc_total_subtotal": "9000",
"doc_total_descto_porciento": "0",
"doc_total_descto_pesos": "0",
"doc_total_exento": "0",
"doc_total_neto": "9000",
"doc_total_iva": "1710",
"doc_total": "9948",
"doc_total_peso_kg": "0",
"doc_observaciones": "",
"doc_canalventa": "MERCADO LIBRE",
"doc_centrocosto": "ffff",
"doc_sucursal": "C. Matriz",
"doc_bodega": "BODEGA CALZADOS",
"doc_listaprecio": "Lista Base",
"cliente_id": "2114",
"cliente_codigo": "",
"cliente_rut": "55.555.555-5",
"cliente_razon_social": "Mimo & Tech LTDA",
"cliente_nombre_fantasia": "Comercial Mimotech",
"cliente_giro": "INFORMATICA",
"cliente_direccion_principal": "AV SUECIA 40",
"cliente_comuna_principal": "Arauco",
"cliente_region_principal": "Biobío",
"cliente_direccion": "AV SUECIA 40",
"cliente_comuna": "Arauco",
"cliente_region": "Biobío",
"cliente_contacto": "Maria Isabel ",
"cliente_telefono": "22210329",
"cliente_celular": "51199358",
"cliente_email": "eperez@norditech.cl",
"empresa_logotipo": "https://obuma-cl.s3.us-east-2.amazonaws.com/imagenes_logos_empresas/logotipo-2.jpg",
"empresa_razon_social": "EMPRESA DE PRUEBA TEST",
"empresa_rut": "99.999.999-9",
"empresa_giro": "SERVICIOSxxxxxxx",
"empresa_telefono": "2233223",
"empresa_email": "ferrecenter.chile@gmail.com",
"empresa_website": "www.empresaprueba.cl",
"empresa_direccion": "AVDA ISABEL RIQUELME 2532",
"empresa_comuna": "Pedro Aguirre Cerda",
"empresa_region": "Metropolitana",
"doc_detalle": [
  {
"linea": 1,
"id": "47156",
"sku": "CHUCER",
"nombre": "Chuleta cerdo",
"descripcion": "",
"unidad_medida": "KG",
"imagen": "https://obuma-cl.s3.us-east-2.amazonaws.com/imagenes_productos/Empresa-2/cod2-p47156-chuleta_cerdo.jpg",
"link": "",
"exento": "0",
"cantidad": "1",
"precio": "1000",
"descuento_porciento": "0",
"descuento_pesos": "0",
"subtotal": "1000",
"precio_bruto": 1190,
"descuento_pesos_bruto": "",
"subtotal_bruto": 1190,
"producto_id": "47156",
"producto_tipo": "0",
"producto_tipo_nombre": "Estandar",
"categoria": "6160",
"categoria_nombre": "CONGELADOS",
"subcategoria": "0",
"subcategoria_nombre": null,
"fabricante": "",
"fabricante_nombre": null,
"producto_peso_fisico": "0",
"producto_largo": "0",
"producto_ancho": "0",
"producto_alto": "0"
},
  {
"linea": 2,
"id": "47154",
"sku": "LL01",
"nombre": "Lomo liso",
"descripcion": "",
"unidad_medida": "KG",
"imagen": "https://obuma-cl.s3.us-east-2.amazonaws.com/imagenes_productos/Empresa-2/cod2-p47154-lomoliso.jpg",
"link": "",
"exento": "0",
"cantidad": "1",
"precio": "5000",
"descuento_porciento": "0",
"descuento_pesos": "0",
"subtotal": "5000",
"precio_bruto": 5950,
"descuento_pesos_bruto": "",
"subtotal_bruto": 5950,
"producto_id": "47154",
"producto_tipo": "0",
"producto_tipo_nombre": "Estandar",
"categoria": "6160",
"categoria_nombre": "CONGELADOS",
"subcategoria": "0",
"subcategoria_nombre": null,
"fabricante": "",
"fabricante_nombre": null,
"producto_peso_fisico": "0",
"producto_largo": "0",
"producto_ancho": "0",
"producto_alto": "0"
},
  {
"linea": 3,
"id": "47155",
"sku": "LV001",
"nombre": "Lomo vetado",
"descripcion": "",
"unidad_medida": "KG",
"imagen": "https://obuma-cl.s3.us-east-2.amazonaws.com/imagenes_productos/Empresa-2/cod2-p47155-lomovetado.jpg",
"link": "",
"exento": "0",
"cantidad": "1",
"precio": "1000",
"descuento_porciento": "0",
"descuento_pesos": "0",
"subtotal": "1000",
"precio_bruto": 1190,
"descuento_pesos_bruto": "",
"subtotal_bruto": 1190,
"producto_id": "47155",
"producto_tipo": "0",
"producto_tipo_nombre": "Estandar",
"categoria": "6160",
"categoria_nombre": "CONGELADOS",
"subcategoria": "0",
"subcategoria_nombre": null,
"fabricante": "",
"fabricante_nombre": null,
"producto_peso_fisico": "0",
"producto_largo": "0",
"producto_ancho": "0",
"producto_alto": "0"
},
  {
"linea": 4,
"id": "534575",
"sku": "112233",
"nombre": "Congelaados del mar",
"descripcion": "",
"unidad_medida": "UN",
"imagen": "https://api.obuma.cl/obuma2.0/imagenes/imagen-no-disponible.jpg",
"link": "",
"exento": "0",
"cantidad": "1",
"precio": "2000",
"descuento_porciento": "0",
"descuento_pesos": "0",
"subtotal": "2000",
"precio_bruto": 2380,
"descuento_pesos_bruto": "",
"subtotal_bruto": 2380,
"producto_id": "534575",
"producto_tipo": "0",
"producto_tipo_nombre": "Estandar",
"categoria": "6160",
"categoria_nombre": "CONGELADOS",
"subcategoria": "15168",
"subcategoria_nombre": "Moluscos",
"fabricante": "2293",
"fabricante_nombre": "prueba 001",
"producto_peso_fisico": "0",
"producto_largo": "0",
"producto_ancho": "0",
"producto_alto": "0"
}
],
"doc_total_descto_pesos_items": 0,
"doc_detalle_referencia": [
  {
"ref_linea": "1",
"ref_tipodcto": "COT",
"ref_tipodcto_nombre": "Cotizaci?n",
"ref_folio": "573",
"ref_fecha": "01-02-2022",
"ref_razon": "",
"ref_codigo": ""
}
],
"doc_detalle_pago": [
  {
"pago_linea": 1,
"pago_fecha": "07-02-2022",
"pago_fecha_ingreso": "07 13:52:38-02-2022",
"pago_monto": "1000",
"pago_monto_sin_flujo": "0",
"pago_monto_por_pagar": "8948",
"pago_no_genera_flujo": "0",
"pago_forma_id": "152",
"pago_forma": "Tarjeta de Credito",
"pago_detalle": "prueba api"
}
],
"vendedor_id": "48",
"vendedor_codigo": "3333",
"vendedor_nombre": "demo 5 5 5",
"vendedor_email": "soporte@obuma.cl;eperez@obuma.cl",
"vendedor_telefono": "225884499",
"vendedor_celular": "2211223",
"vendedor_firma_digital": "",
"usuario_id": "48",
"usuario_codigo": "3333",
"usuario_nombre": "demo 5 5 5",
"usuario_email": "soporte@obuma.cl;eperez@obuma.cl",
"usuario_telefono": "225884499",
"usuario_celular": "2211223",
"usuario_firma_digital": ""
}
],
"info": [
  "doc_tipo",
  "doc_folio",
  "doc_hora_ingreso",
  "doc_fecha_vencimiento",
  "doc_fecha_entrega",
  "doc_total_subtotal",
  "doc_total_descto_pesos",
  "doc_total_neto",
  "doc_total",
  "doc_observaciones",
  "doc_centrocosto",
  "doc_bodega",
  "cliente_id",
  "cliente_rut",
  "cliente_nombre_fantasia",
  "cliente_direccion_principal",
  "cliente_region_principal",
  "cliente_comuna",
  "cliente_contacto",
  "cliente_celular",
  "empresa_logotipo",
  "empresa_rut",
  "empresa_telefono",
  "empresa_website",
  "empresa_comuna",
  "doc_detalle",
  "doc_detalle_referencia",
  "vendedor_id",
  "vendedor_nombre",
  "vendedor_telefono",
  "vendedor_firma_digital",
  "usuario_codigo",
  "usuario_email",
  "usuario_celular",
  null
],
"result": {
"result": "0",
"result_detail": "10-4"
}
}