Una guía de despacho, igual que una factura, se emite desde la orden de compra
que ya ganaste en el Portal: Marko toma los ítems de esa OC, consulta al SII quién es el organismo
comprador y arma un DTE 52 listo para timbrar. Este manual recorre el circuito completo
—llegar a la pantalla, armar la guía, revisar receptor e ítems— y se detiene justo antes de
timbrar el documento: la ventana de confirmación es el último punto en el que se puede dar marcha atrás
sin dejar rastro.
Qué vas a conseguir
Llegar hasta la ventana de confirmación de una guía de despacho electrónica (DTE 52) armada desde una OC del Portal, con el receptor y los ítems ya revisados.
Para quién
La misma pantalla que Emitir Factura: la alcanza quien vea Operaciones → OC Portal. El detalle exacto por rol está en Quién ve esta pantalla.
Qué necesitas antes
La OC ya cargada en OC Portal y el facturador electrónico configurado para tu empresa en Configuración → Integraciones.
Cuánto toma
Un par de minutos. La emisión en sí —si decides completarla— tarda unos segundos: hay una ida y vuelta al facturador.
Este manual no llega a timbrar el documento
Una guía de despacho electrónica, igual que una factura, es un documento tributario: una vez
timbrada y enviada al facturador, no se borra. Por eso estos pasos llegan hasta la ventana de
confirmación —¿Está seguro?— y se detienen ahí. Qué pasa si pulsas Sí, emitir está descrito en
el paso 9, tomado del código, no de haberlo hecho.
El ambiente de estas capturas es de pruebas
Verificado en vivo en Configuración → Integraciones → Facturador Electrónico: el proveedor
configurado para esta empresa de demostración es OpenFactura (Haulmer) y el campo Ambiente
Haulmer está en Ambiente de Pruebas, no en producción. El código coincide con lo que se ve en
pantalla: emitGuide (Cloud Function) fija tipoDTE: 52 e
isDevelopment: facturadorConfig?.environment !== "prod", así que con environment: "dev"
la emisión iría al ambiente de certificación de Haulmer (dev-api.haulmer.com), timbrando a
nombre de la cuenta de pruebas del facturador y no de esta empresa. Aun así, para preparar este
manual no se emitió ninguna guía: se llegó hasta la confirmación y se pulsó Cancelar.
Los pasos
Parte 1 · Llegar a la pantalla
Abre Operaciones en el menú lateral y entra en OC Portal.
Qué deberías verEl grupo Operaciones abierto, con OC Portal arriba del todo y Guías De Despacho al final de la lista, después de Inventario. Encima del menú, el selector de Empresa fija sobre cuál vas a emitir; si tienes más de una, cámbiala antes de seguir.
No hay una entrada de menú «Facturación Electrónica»La pantalla de emisión no está en el menú lateral: se llega a ella siempre desde una OC concreta, porque la guía se arma con los ítems de esa OC. Es el paso 3. Y Guías De Despacho, que sí está en el menú, es otra pantalla: sirve para consultar guías ya emitidas y vincularlas a una OC a proveedor — manual aparte, Consultar y vincular guías de despacho.
Escribe el código de la OC en el buscador de arriba a la izquierda y pulsa Enter.
Qué deberías verUn aviso azul arriba a la derecha: «Se encontró la OC Convenio con folio …», y la lista reducida a esa única OC. El campo trae de fondo el ejemplo Ej: 1234-56-CM78: el código va completo, con guiones y con el sufijo.
Abre la OC, entra en la pestaña Facturas y pulsa el botón verde Ir a facturación electrónica.
Qué deberías verLa ficha Detalle OC 1411-1030-CM26 con sus pestañas (Info, Margen, OC Proveedores, Cotizaciones, Facturas, Histórico Estados, Envío, Actividad, Info Comisiones). Dentro de Facturas, el botón verde Ir a facturación electrónica lleva a la misma pantalla donde se arman tanto la guía como la factura.
También se llega desde el listadoEn la fila de la OC dentro de OC Portal, el menú ⋮ del extremo derecho trae la misma opción, Facturación Electrónica. No la confundas con Vincular Factura, que está justo encima y hace lo contrario: asocia a la OC una factura que ya existe.
Lee la tabla de Documentos Tributarios Electrónicos que esa OC ya tiene antes de crear uno nuevo.
Qué deberías verEl título Documentos Tributarios Electrónicos, con el convenio debajo, los botones Emitir Guía (verde) y Emitir Factura (azul) arriba a la derecha, y una tabla con una fila por documento ya emitido: Folio, Tipo DTE, Fecha Creación, Cliente, Monto y Acciones. Esta OC en concreto ya tiene dos facturas; si la tuya no tiene ningún documento todavía, verás el aviso «No se encontraron documentos tributarios electrónicos para este convenio.»
Este paso evita la guía duplicadaMarko no impide emitir dos guías por los mismos ítems: nada compara lo ya despachado contra lo que vas a emitir. Mira esta tabla antes de tocar Emitir Guía.
Parte 2 · Armar la guía
Pulsa el botón verde Emitir Guía y espera a que cargue el receptor.
Qué deberías verUna ventana titulada Emitir Guía de Despacho - OC «código». Arriba, Detalles de facturación repite literalmente la instrucción que el organismo escribió en la OC; léela, porque suele traer una dirección de envío distinta de la que Marko preselecciona. Debajo, ya cargados: Razón Social (bloqueada), Giro (con lápiz para editarlo), Dirección de facturación —con el enlace Cambiar dirección de facturación si el organismo tiene varias sucursales— y Fecha de Emisión.
Esos datos son del receptor, no los tuyosAunque el rótulo diga sólo Razón Social, lo que ves es el receptor de la guía: Marko consulta al facturador (getTaxpayerHaulmer) con el RUT del comprador de la OC y rellena razón social, giro y dirección con lo que devuelve el SII. Debajo del todo hay además un enlace Cambiar dirección de despacho, independiente de la de facturación: es opcional, y es a dónde va la mercadería.
Revisa siempre la Fecha de EmisiónEl campo se calcula con la fecha de hoy en el navegador, pero convertida a UTC antes de mostrarse. En Chile, que va detrás de UTC, eso puede precargar el día siguiente si emites por la tarde o la noche. Es la fecha que llevará el documento ante el SII: corrígela si hace falta antes de seguir.
Aquí no hay «Previsualizar»A diferencia de Emitir Factura, esta ventana no tiene un botón para ver una maqueta del documento antes de emitir. Lo primero que verás del PDF terminado es después de pulsar Emitir y confirmar.
Marca con la casilla los ítems que vas a despachar y ajusta cantidad, descripción y precio neto.
Qué deberías verUna fila por ítem de la OC. La casilla de la cabecera marca y desmarca todos de golpe. Al marcar un ítem se activan sus campos: Cantidad (arranca en la cantidad de la OC), la descripción —editable, es el texto que sale impreso— y el Precio Neto. El icono de bocadillo bajo Desc. abre un segundo cuadro, «Descripción adicional del item…», de hasta 500 caracteres. Al pie, TOTAL SELECCIONADO se recalcula solo con cada cambio.
Aquí no ves el desglose de IVAA diferencia de Emitir Factura, el pie de esta tabla sólo trae TOTAL SELECCIONADO: no hay líneas de Subtotal ni IVA (19%) antes de emitir. Marko igual los calcula —Neto, IVA y Total— al armar el documento, pero puertas adentro; no se muestran en esta ventana.
Si algún nombre de producto es demasiado largo, pulsa Abreviar items.
Qué deberías verLas descripciones recortadas a los primeros 30 caracteres y el botón cambiado a Restaurar items, que devuelve los nombres completos. Cantidades, precios y totales no cambian: sólo se acorta el texto.
Escribe en Comentario Adicional lo que deba salir impreso en la guía, si hace falta.
Qué deberías verUn cuadro de texto libre bajo la tabla de ítems. Es opcional y va al documento como comentario general, no ligado a ningún ítem en particular.
Parte 3 · La confirmación
Pulsa el botón azul Emitir y decide en la ventana de confirmación.
Qué deberías verUna ventana ¿Está seguro? con el texto «Se emitirá una guía de despacho para los «n» items seleccionados de la OC «código»» y dos botones: Sí, emitir y Cancelar. Mientras decides, el botón Emitir de la ventana de armado, detrás, queda bloqueado con la leyenda Emitiendo...
Qué pasa si pulsas «Sí, emitir» — descrito, no ejecutadoMarko llama a la Cloud Function emitGuide con tipoDTE: 52 y los datos armados. Si el facturador responde con éxito: un aviso «Guía de despacho emitida exitosamente», el PDF se abre en una pestaña nueva, y el documento queda guardado en la OC —con un segundo aviso, «Información de la guía guardada en la OC.»—. La fila nueva aparece en la tabla del paso 4 con la insignia azul Guía de Despacho Electrónica (y la insignia roja Prueba si el ambiente es de certificación, como en este caso) y tres acciones: PDF, Cedible y Marcar como anulada. A partir de ahí no hay vuelta atrás con un simple «eliminar»: lo único disponible es marcarla como anulada dentro de Marko, que —según el propio aviso de esa acción— no anula el documento ante el SII.
Cancelar no cierra la ventana de armadoPulsar Cancelar aquí sólo descarta la confirmación: no se crea ningún documento y la OC queda igual. La ventana Emitir Guía de Despacho, detrás, sigue abierta con la selección, los ajustes y el comentario tal como los dejaste — puedes pulsar Emitir de nuevo o cerrar con el Cancelar de esa ventana. Para este manual se pulsó Cancelar en ambas ventanas: no se emitió ninguna guía.
Quién ve esta pantalla
Es la misma pantalla que Emitir Factura — el mismo botón ⋮ → Facturación Electrónica de OC Portal lleva a las dos—, así que el permiso es idéntico:
Rol
Ve Facturación Electrónica (Emitir Guía / Emitir Factura)
Administrador
Sí, todas las OC
Manager
Sí, todas las OC
Ejecutivo avanzado
Sí, todas las OC
Facturador
Sí, sólo las OC en las que figura como ejecutivo asignado
Ejecutivo
Sí, sólo las OC en las que figura como ejecutivo asignado
Bodeguero
Sí, todas las OC
Gerente de Finanzas
No
El Facturador y el Ejecutivo sólo ven «sus» OCSi alguien de tu equipo de facturación dice que «no le aparece la OC», lo primero que hay que mirar es a quién está asignada, no si tiene el permiso. El Ejecutivo avanzado, el Manager, el Bodeguero y el Administrador las ven todas.
Configurar el facturador es de otro grupo de rolesLa conexión con el facturador electrónico se define en Configuración → Integraciones, y a Configuración sólo llegan Administrador y Manager. Un Facturador que ve el botón Emitir Guía no puede arreglar una integración rota.
Lo que este manual no cubre
Son tareas cercanas, pero cada una tiene su propio flujo:
Emitir una factura de venta (33). El botón azul Emitir Factura, al lado de Emitir Guía en la misma pantalla — manual aparte, Emitir una factura de venta electrónica.
Consultar, filtrar y vincular guías ya emitidas. Eso vive en Operaciones → Guías De Despacho, y ahí se puede además asociar una guía a una OC a proveedor. Manual aparte, Consultar y vincular guías de despacho.
Marcar una guía como anulada, o revertir esa marca. Son los botones de la fila de un documento ya emitido, fuera del alcance de este manual porque suponen que la guía ya existe.
El flujo con otro facturador. Si tu empresa usa RelBase en vez de Haulmer, la ventana pide además ciudad y comuna de despacho mediante un selector propio. ALIMENTOS SPA usa Haulmer, que es lo que documenta este manual.
Configurar el facturador electrónico. Proveedor, token, actividad económica y ambiente se definen una vez en Configuración → Integraciones.
Emitir sin OC. No se cubre porque no se puede: mira la sección siguiente.
Lo que todavía no hace
No se puede emitir una guía suelta. Toda guía sale de una OC de Portal. Si el despacho no tiene OC en Marko, no hay forma de generarla desde aquí.
No hay Previsualizar. A diferencia de Emitir Factura, no existe una maqueta del documento antes de confirmarlo.
No se pueden agregar datos de referencia. El modal de factura permite referenciar otro documento (folio, tipo y fecha); el de guía no tiene ese bloque en absoluto.
No muestra el Subtotal ni el IVA en pantalla. Sólo ves TOTAL SELECCIONADO; el desglose lo calcula el backend al emitir.
No avisa de la guía duplicada. Nada compara lo ya despachado contra lo que estás por emitir — el control es visual, mirando la tabla del paso 4.
Anular en Marko no anula ante el SII. «Marcar como anulada» es un rótulo interno; el propio aviso de esa acción pide anular antes el documento en el portal del facturador.
No hay borradores. Si cierras la ventana de armado, la selección de ítems, los precios ajustados y el comentario se pierden.
La fecha de emisión puede arrancar en el día siguiente. Se calcula en UTC; revísala siempre (paso 5).
Para consultar después
Dónde se emite
Desde la OC: Operaciones → OC Portal → Facturas → Ir a facturación electrónica (o ⋮ → Facturación Electrónica). No hay entrada de menú propia.
Qué documento se emite
Guía de Despacho Electrónica, DTE tipo 52.
Facturadores soportados
Haulmer, Bsale y RelBase. ALIMENTOS SPA usa Haulmer, en Ambiente de Pruebas.
De dónde salen los datos del receptor
Del RUT del comprador de la OC, consultado al facturador (getTaxpayerHaulmer): razón social, giro, dirección y sucursales.
Cómo se calculan los totales
Neto = suma de cantidad × precio neto de los ítems marcados. IVA = 19% del neto, redondeado. Total = Neto + IVA. Se calculan al emitir; en pantalla sólo ves el neto (Total Seleccionado).
Abreviar items
Recorta las descripciones a los primeros 30 caracteres. Restaurar items las devuelve completas.
Descripción adicional por ítem
Hasta 500 caracteres, en el icono de bocadillo de la columna Desc.
Insignia «Prueba»
El documento se emitió contra el ambiente de certificación del facturador. Sin valor tributario.
Acciones sobre una guía ya emitida
PDF, Cedible y Marcar como anulada / Revertir anulación. No existe «Anular con nota de crédito»: eso es sólo para facturas (33).
Cuando algo no sale
Lo que ves
Qué pasa
«Debe seleccionar al menos un ítem para emitir la guía.»
No marcaste ninguna casilla. Marca los ítems y vuelve a pulsar Emitir.
«Debe seleccionar una ciudad y comuna para emitir la guía con RelBase.»
Sólo si tu empresa usa RelBase: falta completar el selector de ciudad/comuna del despacho.
«No se pudo obtener la información del usuario autenticado.»
La sesión se perdió a mitad de camino. Vuelve a iniciar sesión e inténtalo de nuevo.
«Datos inválidos o ítems no seleccionados para emitir la guía.»
La OC no tiene ítems, o llegó incompleta a la ventana. Vuelve a OC Portal y entra de nuevo.
«Error de Servicio» al emitir
La llamada al facturador falló — red, credenciales, o el propio facturador caído. Antes de reintentar, vuelve a la tabla de documentos y comprueba si la guía se creó igualmente: reintentar a ciegas es como se emiten guías duplicadas.
«La configuración del facturador … no está disponible»
Tu empresa no tiene el facturador electrónico configurado. Lo arregla un Administrador o Manager en Configuración → Integraciones.
«El campo … del emisor es requerido…»
A la configuración de tu empresa le falta un dato del emisor (dirección, actividad económica, código de sucursal SII). Se completa en Configuración → Integraciones.
Error al cargar datos de la compañía
Falló la lectura de la ficha de tu empresa justo al pulsar Emitir. Cierra la ventana y vuelve a intentarlo.