API Endpoint Specification
This section describes the API endpoint that your ERP system must call to send vendor numbers back to B1Link.
Endpoint Details
- Method:
PUT - Path:
/api/onboarding-request-erp-events/assign-erp-vendor-number-event - Base URL: Contact your B1Link administrator for the base URL (use
{baseUrl}in your requests) - Authentication: API key via HMAC-SHA256 signature (see Signature Generation)
- Content-Type:
application/json
Headers
| Header | Required | Description |
|---|---|---|
Content-Type | Yes | Must be application/json |
X-B1LINK-Signature | Yes | HMAC-SHA256 signature of the request body, Base64-encoded. See Signature Generation for details. |
Request Example
PUT {baseUrl}/api/onboarding-request-erp-events/assign-erp-vendor-number-event HTTP/1.1
Content-Type: application/json
X-B1LINK-Signature: <computed-signature>
Content-Length: 89
{
"Id": "550e8400-e29b-41d4-a716-446655440000",
"ErpVendorNumber": "VENDOR-12345"
}
Next Steps
- Request Payload Structure - Learn about the request body format
- Signature Generation - Understand how to generate the signature
- Complete Request Example - See full working examples