Integration Guide

This section explains how to integrate your ERP system with B1Link's vendor number assignment endpoint.

Topics

• API Endpoint Specification - The API endpoint you'll call to send vendor numbers to B1Link
• Request Payload Structure - JSON payload format and field descriptions
• Signature Generation - How to generate HMAC-SHA256 signatures
• Request Examples - Complete working examples

Integration Workflow

1. Receive Incoming Webhook from B1Link - Your webhook receiver endpoint receives supplier information via HTTP POST
2. Extract Event ID - Get the onboardingRequestErpEventId from the incoming webhook payload
3. Process Supplier Information - Handle the supplier data in your ERP system
4. Assign Vendor Number - Create a vendor number according to your business rules
5. Call API Endpoint - Make a PUT request to the API endpoint with the vendor number and signature

Requirements

• ✅ Valid API key stored securely
• ✅ Correct JSON payload format
• ✅ Valid HMAC-SHA256 signature
• ✅ Proper HTTP headers
• ✅ HTTPS communication only

Continue to the next sections for detailed implementation instructions.