address validation
Configured with Filter, HTTP Request, Split Out, Wait, and additional nodes. Review the connections and setup before adapting this template.
Node categories in this workflow
- Web / API
- Transform
- Wait
- Routing
- Trigger
Icons describe general node roles, inferred from node types. Inspect the parameters for the configured action.
Drag to pan; use + and − to zoom. Reconstructed from the exported node positions; nothing runs here. Dashed lines represent non-main connections. Full node names and notes appear below.
How it works
The exported workflow contains the following configured nodes. Their connections are shown above; inspect the JSON for the complete logic, expressions, and external actions.
| Node | Category | Type | Operation |
|---|---|---|---|
| get order data | Web / API | HTTP Request | See node parameters |
| Split Out Order Data | Transform | Split Out | See node parameters |
| Set Address Fields | Transform | Edit Fields | See node parameters |
| Check Address endereco api | Web / API | HTTP Request | POST |
| Split Out Corrected Address | Transform | Split Out | See node parameters |
| set new delivery address to billbee | Web / API | HTTP Request | PATCH |
| Wait | Wait | Wait | See node parameters |
| Wait1 | Wait | Wait | See node parameters |
| check if new address is not empty | Routing | If | See node parameters |
| set billbee tag | Web / API | HTTP Request | POST |
| check if housenumer is not empty | Routing | If | See node parameters |
| check if addressline 2 contains number | Routing | If | See node parameters |
| Filter | Routing | Filter | See node parameters |
| set value of addressline2 as housenumber | Transform | Edit Fields | See node parameters |
| Filter Out PickUpShops | Routing | Filter | See node parameters |
| check if addressline 2 contains number and letter | Routing | If | See node parameters |
| set billbee tag manual check | Web / API | HTTP Request | POST |
| set value of addressline2 as housenumber number+letter | Transform | Edit Fields | See node parameters |
| set billbee success | Web / API | HTTP Request | POST |
| ConfigNode | Transform | Edit Fields | See node parameters |
| Webhook | Trigger | Webhook | See node parameters |
Setup
- Download the JSON and import it into an isolated n8n instance. Leave the workflow inactive.
- Connect your own credentials through n8n’s credential store. Replace
REPLACE_WITH_*values with your resource identifiers. - Inspect API destinations, Code nodes, database queries, file paths, and outbound actions.
- Run with synthetic data and harmless destinations. Enable triggers only after checking the actual outputs.
Requirements
An n8n instance with the listed node types and compatible versions. Service-connected workflows may require accounts, credentials, or paid APIs.
Credential types declared in the source
None declared. HTTP requests and Code nodes may still need configuration.
Workflow notes
**Address Validation Workflow**
Address Validation Workflow
Requirements
- Billbee Developer API Key: Request via email:
user@example.com. - Billbee User API Key: Found in the Billbee settings.
- Endereco API Key: Register at Endereco API. 30-Day Free Trial available.
About
This workflow automates the process of validating client shipping addresses, saving time and reducing errors. Your warehouse team will appreciate it!
How it Works
- Start: The workflow is triggered by a Webhook sent from Billbee (see configuration). The webhook provides the Order ID.
- Retrieve Order Data: Use the Order ID to call the Billbee Order Endpoint. This fetches the client's shipping address.
- Data Mapping and Manipulation: Rename and map the fields. Apply optional filters and data adjustments. 3.1 Validating the housenumber (Most common error)
- Validate Address: Send the shipping address to the Endereco API. The API validates the address and, if necessary, suggests a corrected address.
- Conditional Check: Was a new address suggested? Yes: Update the client’s shipping address in Billbee. No: Add a "Validation Error" tag to the Billbee order.
- Tag the Order: For successfully validated orders, add a tag in Billbee to mark them as processed.
Benefits
- Time-Saving: Automates address validation, reducing manual effort.
- Error Reduction: Identifies incorrect addresses and suggests corrections automatically.
- Transparency: Tracks the validation status with tags in Billbee.
API Docs
API Docs
Endereco: https://github.com/Endereco/enderecoservice_api
Billbee: https://app.billbee.io//swagger/ui/index
Bilbee Setup
Bilbee Setup
Rule Settings
- Name of the Rule: Endereco Address Validation
- Comment: No comment provided.
- Active: ✅ Active
- Stop Rule Processing After This Rule: ⬜ Disabled
Trigger:
- Event: Order imported
- Import Type: All import types
Conditions:
- Restrict Shop: Rule applies only if the order comes from one of the defined shops.
Actions:
- Call External URL:
- URL:
YOUR_N8N_WEBHOOK_LINK?Id={OrderId}This rule ensures that for every imported order from a specific shop, the external webhook URL is triggered with theOrderIdas a parameter.
- URL:
Option 2
If order state gets changed to "gepackt", "In Fulfillment" by this you can manually correct the orders within Billbee as most address are fine. Make sure that the State does not trigger a different automation
Include Filter
Include Filter
You want to filter out PickUp Shops or Parcel Stations for example in Germany:
"Postfiliale, Paketshop, Packstation"
This can also be set up within Billbee
**Setup**
Setup
Create an Basic Auth for BillbeeUser -E-Mail as Username, Password User API Key
Paste your Billbee Developer Key (X Key) and Endereco API Key
**Setup**
Setup
Select your BillbeeUser Basic Auth
address validation
address validation
Purpose and structure
This folder contains the address validation workflow. Its executable nodes use filter, httpRequest, if, set, splitOut, wait, webhook. The table and connection map below are derived from the JSON, not an inferred guarantee of behavior.
Setup
Import inactive. Configure your own credentials and replace REPLACE_WITH_* values. Review external destinations and Code nodes before running.
Entry points
Webhook
Verification
Sanitized source candidate; not runtime-tested. This overview is generated from node metadata. Read the folder README for the connection map, credential types, and license.
Attribution
https://github.com/Zie619/n8n-workflows/blob/94007c1445d9258a7da116646b79473e7c7c3282/workflows/Wait/1727_Wait_Splitout_Create_Webhook.json MIT; preserve source notices.
Canvas section labels
These name areas of the original canvas; they do not include explanatory instructions.
- Get and Prepare Oder Data
- Open ME!
- House Number Validation
- Address Validation & Correction