Validate and fix shipping addresses before orders leave the warehouse. Built for teams using Billbee, it catches missing house numbers and weak address lines so parcels arrive the first time.

A webhook from Billbee sends the order ID to n8n. The flow pulls the order, maps the shipping fields, and filters pickup shops and parcel stations. Smart checks move house numbers from address line 2 when needed. The address then goes to Endereco for real time validation. When a clean suggestion exists, the customer shipping address in Billbee is updated. If no fix is suggested, the order gets a clear fail tag for quick review. Successful checks are tagged so your team knows it is safe to ship.

Setup needs a Billbee Developer API key, a Billbee User API key for Basic Auth, and an Endereco API key. Expect fewer returns, fewer support tickets, and faster packing time. This is strong for shops that import orders from many channels or ship across borders where address formats vary. After connecting the webhook rule in Billbee, run a test order and confirm tags and the address update in Billbee.

• Webhook trigger from Billbee sends the Order ID into n8n
• HTTP request fetches full order data from Billbee using Basic Auth and developer key
• Field mapping normalizes shipping data into simple first name, street, house number, zip, city, and country
• Filters remove pickup shops and parcel stations using keywords like Postfiliale, Paketshop, and Packstation
• House number logic moves numbers from address line 2 when needed and handles number plus letter cases
• Endereco address check runs a JSON RPC call and returns validated suggestions
• Conditional branches update the Billbee shipping address on success or add a fail tag for review
• Wait nodes control timing so updates and tags happen in the right order
• Success tagging marks orders as processed for the warehouse team

• Reduce manual address checks from 10 minutes per order to under 1 minute
• Improve address accuracy by up to 90 percent on common issues like missing house numbers
• Cut failed deliveries and returns by 20 to 40 percent
• Connect Billbee and Endereco without manual exports
• Handle higher order volume with the same warehouse team
• Provide clear tags for pass or review so staff acts faster

1. Import the template into n8n: Create a new workflow in n8n > Click the three dots menu > Select 'Import from File' > Choose the downloaded JSON file.
2. You'll need accounts with Billbee and Endereco. See the Tools Required section above for links to create accounts with these services.
3. In the n8n credentials manager, create a Basic Auth credential for Billbee. Use your Billbee login email as the username and your Billbee User API Key as the password. Give it a clear name like Billbee User Basic.
4. Open the ConfigNode in the workflow and paste your Billbee Developer API Key into the X-Billbee-Api-Key field. Paste your Endereco API Key into the X-Auth-Key-Endereco field and save.
5. Open the get order data and set new delivery address to billbee nodes. In Credential to connect with, select your Billbee User Basic credential. Confirm the X-Billbee-Api-Key header reads from ConfigNode.
6. Open the Check Address endereco api node. Confirm the X-Auth-Key header reads from ConfigNode and the Content-Type is application/json.
7. Copy the Production URL from the Webhook node in n8n. In your Billbee dashboard, create a rule that runs on Order imported or on the packing state you use. Set the action to Call external URL and pass ?Id={OrderId}.
8. In n8n, click Execute Workflow and send a test order through the Billbee rule. Check the run data to confirm the order fetch and the Endereco response.
9. Review the Filter Out PickUpShops node and update the keyword list to match your market and language.
10. Test two cases: one with a clean Endereco suggestion and one with no suggestion. Confirm that the address is patched in Billbee for the first case and that the endereco_address_failed tag is added for the second case.
11. If nothing updates, check that the Billbee User API Key and Developer Key are valid, confirm the Webhook URL is correct in Billbee, and review the Endereco node for a 200 response.
12. After testing, turn on the workflow and keep the Wait nodes as configured to avoid timing issues between API calls.