Overview
This node generates customizable QR Codes with various content types, branded by AtendUP. It supports multiple QR Code formats such as plain text/URL, PIX payment codes, WiFi credentials, vCard contacts, email links, phone/SMS links, and WhatsApp messages. Users can customize colors, size, output format (PNG, JPG, SVG), error correction level, margin, and optionally add a centered logo image.
Common scenarios include:
- Creating payment QR Codes for PIX transactions.
- Sharing WiFi network credentials easily.
- Encoding contact information as vCards.
- Generating quick email or SMS links.
- Providing WhatsApp chat links.
- Embedding URLs or arbitrary text in QR Codes for marketing or informational purposes.
Practical examples:
- A store generating a PIX QR Code to receive payments.
- A café sharing WiFi access via a QR Code on tables.
- An event organizer distributing contact info through vCard QR Codes.
- Marketing campaigns embedding URLs or promotional messages.
Properties
| Name | Meaning |
|---|---|
| Tipo de QR Code | Select the type of QR Code to generate. Options: Texto/URL, PIX, WiFi, Contato/vCard, Email, Telefone/SMS, WhatsApp |
| Conteúdo | Text or URL content for the QR Code (shown if type is Texto/URL) |
| Chave PIX | PIX key (CPF, CNPJ, email, phone, or random key) for PIX QR Code |
| Nome do Beneficiário | Name of the PIX payment beneficiary |
| Cidade | City of the PIX payment beneficiary |
| Valor (opcional) | Optional payment amount for PIX QR Code |
| Descrição (opcional) | Optional description for the PIX payment |
| SSID (Nome da Rede) | WiFi network name (SSID) |
| Senha | WiFi network password |
| Tipo de Segurança | WiFi security type. Options: WPA/WPA2, WEP, Sem Segurança (no password) |
| Nome | Full name for vCard contact |
| Telefone | Phone number for vCard contact |
| Email address for vCard contact | |
| Empresa | Company name for vCard contact |
| Destinatário | Recipient email address for email QR Code |
| Assunto | Subject line for email QR Code |
| Corpo da Mensagem | Body text for email QR Code |
| Número de Telefone | Phone number for phone/SMS QR Code |
| Texto SMS (opcional) | Optional predefined SMS text message |
| Número WhatsApp | WhatsApp phone number including country code |
| Mensagem Pré-definida | Predefined WhatsApp message |
| Cor do Fundo | Background color of the QR Code |
| Cor do Primeiro Plano | Foreground color (dots) of the QR Code |
| Tamanho (px) | Size of the QR Code in pixels (from 200x200 up to 1000x1000) |
| Formato de Saída | Output file format of the QR Code. Options: PNG, JPG, SVG |
| Nível de Correção de Erro | Error correction level of the QR Code. Options: Baixo (L), Médio (M), Quartil (Q), Alto (H) |
| Margem | Margin around the QR Code |
| Upload de Logo Personalizado | URL or base64 string of a custom logo image to center on the QR Code (not supported for SVG output) |
| Batch Generation | Whether to generate multiple QR Codes at once (boolean) |
| Templates Prontos | Apply a predefined style template. Options: Nenhum, Corporativo, Casual, E-commerce |
Output
The node outputs an array with one JSON object per input item containing:
qrCodeType: The selected QR Code type.qrData: The raw data encoded in the QR Code (e.g., URL, vCard text, PIX payload).qrCodeImage: The generated QR Code image as a base64 data URL (PNG, JPG, or SVG).format: The output image format.size: The pixel size of the QR Code.generatedBy: Branding string "AtendUP - atendup.com - Tel: (45) 99969-1163".timestamp: ISO timestamp of generation.
If a custom logo is provided and the output format is not SVG, the logo is composited centered on the QR Code image.
Dependencies
- Uses the
qrcodelibrary for QR Code generation. - Uses
qrcode-pixfor generating PIX payment QR Code payloads. - Uses
jimpfor image processing when adding a custom logo overlay. - No external API calls are made; all generation is local.
- No special credentials or environment variables required.
Troubleshooting
- Unsupported QR Code Type: If an unsupported QR Code type is selected, the node throws an error indicating the type is not supported. Ensure you select one of the predefined types.
- Invalid Input Data: Missing or invalid parameters for specific QR Code types (e.g., missing PIX key or WiFi SSID) may cause errors during generation. Verify all required fields are filled correctly.
- Custom Logo Issues: Providing an invalid URL or malformed base64 string for the custom logo will cause image processing errors. Confirm the logo source is accessible and properly formatted.
- SVG Format Limitations: Custom logos cannot be added to SVG output due to image compositing limitations. Choose PNG or JPG if you want to add a logo.
- Size Constraints: The QR Code size must be between 200 and 1000 pixels. Values outside this range may cause errors or unexpected results.
- Batch Generation: Although there is a batch generation option, the current implementation processes each input item individually. Large batches may increase execution time.