← All N8N workflows
Automation & utilitiesFilterHTTP RequestIfEdit FieldsSplit Out

address validation

Configured with Filter, HTTP Request, Split Out, Wait, and additional nodes. Review the connections and setup before adapting this template.

Workflow preview
Web / APIget order dataHTTP RequestTransformSplit Out Order DataSplit OutTransformSet Address FieldsEdit FieldsWeb / APICheck Address enderecoapiHTTP RequestTransformSplit Out CorrectedAddressSplit OutWeb / APIset new deliveryaddress to billbeeHTTP RequestWaitWaitWaitWaitWait1WaitRoutingcheck if new address isnot emptyIfWeb / APIset billbee tagHTTP RequestRoutingcheck if housenumer isnot emptyIfRoutingcheck if addressline 2contains numberIfRoutingFilterFilterTransformset value ofaddressline2 as…Edit FieldsRoutingFilter Out PickUpShopsFilterRoutingcheck if addressline 2contains number and…IfWeb / APIset billbee tag manualcheckHTTP RequestTransformset value ofaddressline2 as…Edit FieldsWeb / APIset billbee successHTTP RequestTransformConfigNodeEdit FieldsTriggerWebhookWebhook

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.

Workflow node names, types, and operations
NodeCategoryTypeOperation
get order dataWeb / APIHTTP RequestSee node parameters
Split Out Order DataTransformSplit OutSee node parameters
Set Address FieldsTransformEdit FieldsSee node parameters
Check Address endereco apiWeb / APIHTTP RequestPOST
Split Out Corrected AddressTransformSplit OutSee node parameters
set new delivery address to billbeeWeb / APIHTTP RequestPATCH
WaitWaitWaitSee node parameters
Wait1WaitWaitSee node parameters
check if new address is not emptyRoutingIfSee node parameters
set billbee tagWeb / APIHTTP RequestPOST
check if housenumer is not emptyRoutingIfSee node parameters
check if addressline 2 contains numberRoutingIfSee node parameters
FilterRoutingFilterSee node parameters
set value of addressline2 as housenumberTransformEdit FieldsSee node parameters
Filter Out PickUpShopsRoutingFilterSee node parameters
check if addressline 2 contains number and letterRoutingIfSee node parameters
set billbee tag manual checkWeb / APIHTTP RequestPOST
set value of addressline2 as housenumber number+letterTransformEdit FieldsSee node parameters
set billbee successWeb / APIHTTP RequestPOST
ConfigNodeTransformEdit FieldsSee node parameters
WebhookTriggerWebhookSee node parameters

Setup

  1. Download the JSON and import it into an isolated n8n instance. Leave the workflow inactive.
  2. Connect your own credentials through n8n’s credential store. Replace REPLACE_WITH_* values with your resource identifiers.
  3. Inspect API destinations, Code nodes, database queries, file paths, and outbound actions.
  4. 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

  1. Start: The workflow is triggered by a Webhook sent from Billbee (see configuration). The webhook provides the Order ID.
  2. Retrieve Order Data: Use the Order ID to call the Billbee Order Endpoint. This fetches the client's shipping address.
  3. Data Mapping and Manipulation: Rename and map the fields. Apply optional filters and data adjustments. 3.1 Validating the housenumber (Most common error)
  4. Validate Address: Send the shipping address to the Endereco API. The API validates the address and, if necessary, suggests a corrected address.
  5. 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.
  6. 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 the OrderId as a parameter.

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

More in Automation & utilities