Marko Manual de uso · Financiero

Paso a paso

Emitir una guía de despacho electrónica

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

  1. Abre Operaciones en el menú lateral y entra en OC Portal.

    Menú lateral con el grupo Operaciones desplegado, mostrando OC Portal, Proveedores, OC Proveedores, OC Proveedores (Kanban), Pagos Proveedores, OT / Despachos, Inventario y Guías De Despacho.
    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.
  2. Escribe el código de la OC en el buscador de arriba a la izquierda y pulsa Enter.

    Buscador de OC Portal con el código 1411-1030-CM26 escrito y un aviso azul: Se encontró la OC Convenio con folio 1411-1030-CM26. La tabla queda reducida a esa fila, con Dirección General de Gendarmería de Chile como comprador.
    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.
  3. Abre la OC, entra en la pestaña Facturas y pulsa el botón verde Ir a facturación electrónica.

    Ficha Detalle OC 1411-1030-CM26, pestaña Facturas seleccionada, con un buscador de folio, un botón Vincular y el botón verde Ir a facturación electrónica, sobre las tarjetas Total OC, Total Facturado y Pendiente de Facturar.
    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.
  4. Lee la tabla de Documentos Tributarios Electrónicos que esa OC ya tiene antes de crear uno nuevo.

    Pantalla Facturación Electrónica de la OC 1411-1030-CM26, con los botones Emitir Guía y Emitir Factura arriba a la derecha, y una tabla con dos facturas electrónicas ya emitidas: folios 1851 y 1865.
    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

  1. Pulsa el botón verde Emitir Guía y espera a que cargue el receptor.

    Ventana Emitir Guía de Despacho - OC 1411-1030-CM26, con los botones Abreviar items, Cancelar y Emitir arriba, el texto Detalles de facturación tomado de la OC, y los campos Razón Social (bloqueado), Giro, Dirección de facturación y Fecha de Emisión.
    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.
  2. Marca con la casilla los ítems que vas a despachar y ajusta cantidad, descripción y precio neto.

    Tabla de ítems de la guía con dos productos marcados: Huevo Extra 61-68 GR Blanco 20 Unidades RM (cantidad 150) y Arroz Tucapel Grado 2 Bolsa 1 K Unidad RM (cantidad 100). Al pie, Total Seleccionado 683.655 pesos.
    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.
  3. Si algún nombre de producto es demasiado largo, pulsa Abreviar items.

    Misma ventana con los nombres de los productos recortados a 30 caracteres y el botón cambiado a Restaurar items. Cantidades y precios no cambian.
    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.
  4. Escribe en Comentario Adicional lo que deba salir impreso en la guía, si hace falta.

    Campo Comentario Adicional con el texto de ejemplo: Despacho parcial, saldo se factura en la próxima guía.
    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

  1. Pulsa el botón azul Emitir y decide en la ventana de confirmación.

    Ventana de confirmación ¿Está seguro? con el texto: Se emitirá una guía de despacho para los 2 items seleccionados de la OC 1411-1030-CM26, y los botones Sí, emitir y Cancelar. Detrás, el botón Emitir del modal aparece deshabilitado con la leyenda Emitiendo.
    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:

RolVe Facturación Electrónica (Emitir Guía / Emitir Factura)
AdministradorSí, todas las OC
ManagerSí, todas las OC
Ejecutivo avanzadoSí, todas las OC
FacturadorSí, sólo las OC en las que figura como ejecutivo asignado
EjecutivoSí, sólo las OC en las que figura como ejecutivo asignado
BodegueroSí, todas las OC
Gerente de FinanzasNo
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:

Lo que todavía no hace

Para consultar después

Dónde se emiteDesde 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 emiteGuía de Despacho Electrónica, DTE tipo 52.
Facturadores soportadosHaulmer, Bsale y RelBase. ALIMENTOS SPA usa Haulmer, en Ambiente de Pruebas.
De dónde salen los datos del receptorDel RUT del comprador de la OC, consultado al facturador (getTaxpayerHaulmer): razón social, giro, dirección y sucursales.
Cómo se calculan los totalesNeto = 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 itemsRecorta las descripciones a los primeros 30 caracteres. Restaurar items las devuelve completas.
Descripción adicional por ítemHasta 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 emitidaPDF, 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 vesQué 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 emitirLa 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ñíaFalló la lectura de la ficha de tu empresa justo al pulsar Emitir. Cierra la ventana y vuelve a intentarlo.