Emision masiva de DTE via CSV

https://www.obuma.cl/ayuda/articulo/283


Para los casos en que se requiera la emisión masiva de DTE (Documentos Tributarios Electrónicos), existe la opción de utilizar un excel para la emisión masiva.

 

🧾 Estructura del archivo CSV

El archivo debe tener una estructura fija, tanto en orden como en nombre de columnas.

 

 

  COLUMNA DESCRIPCION OBLIGATORIO OPCIONES
0 dte_tipo

Indicar el codigo de tipo dcto segun tabla DTE

33 = Factura

   
1 dte_folio      
2 dte_fecha Indicar la fecha de emision del documento   Si no indica toma fecha del dia
3 dte_fecha_vencimiento Indicar la fecha de vencimiento    
4 cliente_rut      
5 cliente_razonsocial      
6 cliente_giro      
7 cliente_telefono      
8 cliente_email      
9 cliente_direccion      
10 cliente_comuna      
11 item_codigo      
12 item_exento Indicar 1 si el item es exento    
13 item_nombre Indicar el nombre del item (producto y/o servicio)    
14 item_descripcion      
15 item_cantidad Indicar la cantidad    
16 item_unidad Indicar la unidad de medida    
17 item_precio Indicar el precio unitario en PESOS    
18 item_descuento Indicar el descuento sobre el precio unitario en %    
19 dte_referencia Indicar las referencias del documento   

TIPO_DTE|FOLIO|FECHA|RAZO|TEXTO

Usar & para separar mas de una referencia

33|500|2017-01-10|razon|codigo&33|501|2017-01-11|| 

TipoDcto|FolioDcto|FechaDcto|razon|codigo

& se usa para añadir otra referencia al mismo dcto.

20  dte_vendedor   Indicar el codigo del vendedor    
21 guia_tipo_traslado     1 > Operacion constituye venta
2 > Ventas por efectuar
3 > Consignaciones
4 > Entrega Gratuita
5 > Traslados internos
6 > Otros traslados no venta
7 > Guia de devolucion
22 guia_tipo_despacho     1 > Por cuenta CLIENTE
2 > EMISOR a instalaciones cliente
3 > EMISOR a OTRAS instalaciones cliente
         
         

 

Considerar lo siguiente :

  • La primera linea de cada dcto debe indicar un folio de referencia o control solamente, porque OBUMA al crear la factura asigna el folio automaticamente.
  • En la primera linea van siempre los datos generales del documento y el primer item
  • Si un documento tiene más de un item, se agregan en lineas adicionales como muestra el ejemplo, pero agregando solo los datos del item

 

 

El archivo debe ser guardado en formato CSV ( delimitado por comas )

 

 

 

Al momento de subir el archivo debes tener las siguientes consideraciones:

1.- Asegurate de que has guardado el archivo como CSV ( Delimitado por comas (punto y coma, no coma solo) ; ) 

OJO : Si lo haces desde un MAC, tener en cuenta que el separador sea ; y no ,

2.- No modifiques la estructura del archivo, no puedes cambiar ni el orden de las columnas, ni el nombre de las mismas.

3.- Los valores deben ir sin separador de miles, y si lleva decimales usar el separador . ( punto )

 

 


⚠️ Consideraciones importantes

  • OBUMA asigna automáticamente el folio tributario, el valor del campo dte_folio se utiliza solo como referencia interna

  • Un error en la estructura del CSV puede provocar rechazo del archivo completo

  • Se recomienda validar el archivo con pocos registros antes de cargas masivas grandes

  • El sistema genera una vista previa antes de permitir la emisión de los documentos.

 

 


✅ Buenas prácticas recomendadas

  • Probar con 1 o 2 documentos antes de cargas grandes

  • Validar RUT, correos y direcciones previamente

  • Usar Excel solo como editor, no modificar el orden de columnas

  • Mantener una copia de respaldo del CSV original

  • Revisar pendientes antes de la emisión definitiva