Conectar con tu sistema · Manual de Portadoc

#Si ya tienes un programa de gestión

Dónde estáConfiguración›Integración

Este capítulo es para quien tenga a alguien que programe. Si emites los documentos a mano, puedes saltártelo entero: no te falta nada por no usarlo.

La idea es sencilla: tu programa ya sabe qué porte vas a hacer. En vez de volver a teclearlo aquí, lo manda y Portadoc devuelve el documento emitido con su número, su URL y su QR.

Claves de API y avisos salientes, en la misma pantalla.

#Llevar el QR en tu propio albarán

El conductor ya lleva el albarán que imprime tu programa de gestión. Si el QR del DeCA va impreso ahí, lleva un papel en vez de dos, y cuando un agente lo escanea se descarga el DeCA igual que si hubiera escaneado el documento nuestro.

Abre la plantilla del albarán en el diseñador de informesEl mismo sitio donde está el logotipo.
Arrastra un campo imagen a un hueco libreAbajo a la derecha suele sobrar sitio. Con 3 × 3 cm basta.
Dile que la imagen viene de una dirección webY que esa dirección es la del DeCA cambiándole el .pdf final por .png. En la tabla de abajo está dónde se escribe eso en cada programa.
Guarda e imprime uno de pruebaEscanéalo con el móvil.

La dirección es la del documento con otra extensión. Si el DeCA está en …/DECA-2026-000150.pdf, su QR está en …/DECA-2026-000150.png — y en .svg si tu informe prefiere vectores, o en .txt si lo que necesitas es la cadena que el código lleva dentro. La devuelve también la API, en el apartado qr de cada documento, para no tener que construirla.

Si tu informe lo hace con…	Dónde se pone la dirección
Crystal Reports	Imagen → Formato → Ubicación del gráfico, como fórmula.
SSRS, Report Builder, RDL	Imagen → Origen: Externo → Valor, como expresión.
JasperReports	Elemento `image` → `imageExpression`.
FastReport	Objeto Picture: su propiedad de URL, o `LoadFromURL` en el script.
DevExpress XtraReports	XRPictureBox → expresión de `ImageSource`.
Stimulsoft	Imagen → `ImageURL`.
Telerik Reporting	PictureBox → `Value`.
Una plantilla HTML, Word o LibreOffice	Una imagen enlazada: `img src`.
Un control de código de barras QR propio	Ahí no hace falta la imagen: dale la cadena (el `.txt`) y que la dibuje él.

Los nombres exactos cambian de una versión a otra, pero la idea es la misma en todos: un campo imagen que, en vez de un fichero fijo, recibe una dirección. Es la misma operación que poner el logotipo, con la diferencia de que la dirección cambia en cada albarán.

Dos detalles de impresión. La imagen ya trae el marco blanco que la norma del código exige alrededor: no la recortes ni la pegues a un borde, o el QR se leerá en tu pantalla y fallará en el arcén. Y si tu informe no escala las imágenes, pídela del tamaño que necesites añadiendo ?px=600 al final.

#Claves de API

Creas una clave, le das sólo los permisos que necesite, y se la das a quien vaya a programar la conexión.

Permiso	Deja hacer
Consultar documentos	Leer lo emitido.
Emitir documentos nuevos	Crear DeCA.
Modificar documentos existentes	Cambiarlos.
Consultar clientes, flota y conductores	Leer los catálogos.
Dar de alta clientes, flota y conductores	Escribir en los catálogos.

#Avisos a tu sistema (webhooks)

Al revés que la API: en vez de que tu programa pregunte, Portadoc le avisa cuando pasa algo. Pones una dirección y marcas qué te interesa.

Evento	Cuándo salta
Se emite un documento	Al emitir.
Se modifica un documento	Al modificarlo.
Un documento se sustituye por otro	Al generar el sustituto.
Se entrega la copia al conductor	Al enviársela.
Se escanea el QR desde la carretera	En el momento en que un agente verifica. Es el que más se pide.
El conductor anota una incidencia	Cuando escribe desde su app.

Los avisos van firmados, para que tu sistema pueda comprobar que vienen de verdad de aquí. Y se reintentan si tu servidor no contesta: no se pierden porque estuvieras caído un rato.

En Últimas entregas se ve qué se ha mandado, a dónde y si llegó. Es el primer sitio donde mirar cuando alguien dice «no me llega nada».