About Bill.com network
NOTE: Each API call requires a session ID (generated with Login API request).
Bill.com provides several ways to set up ePayment connections to your customers and vendors. When organizations are connected in the Bill.com network, payments can be sent and received faster and more securely.
- The entity (vendor or customer) name is used to check if that entity is already part of the Bill.com network.
- The displayed results can show several exact name matches and near-matches (similar names, addresses, etc.).
- If one of these results is the correct organization (vendor or customer), an invitation can be sent to connect.
- If no organization match exists, invitations can be sent to the organization who has the option to register in Bill.com and transfer funds with ePayments.
Network connections can be made with API calls, To do this, you must use the Vendor API or Customer API to generate a record in the Bill.com system. The record can also be created with a sync to accounting software or imported with a CSV file.
- As needed, create a Vendor or Customer.
- Use NetworkSearch to check both the Bill.com Network and Large Biller Vendor networks. Exact and similar matches will be returned (maximum of 25 results). The return can be sorted on combinations of name, zip code, and account number.
- For Customers and Vendors in the Network: if there is a match, use SendInvite to connect. If the invitee accepts, the connection is confirmed.
- For Large Biller Vendors(these are organizations with a wide national or regional presence), see Large Biller Workflow for details.
- For Vendors that do not match any of the results, use Vendor Invite Workflow to request the Vendor register as part of the Bill.com network and receive ePayments for free. The connection is made if the Vendor invitee accepts the invite and successfully adds their bank account details.
- For Customers that do not show matches, a part of the email generated with the SendInvoice call includes an invitation to sign up for a free Bill.com account.
Get Network Status API
To check if there are an outstanding invitation for a vendor or customer, use the GetNetworkStatus call with the organization Id. The return provides the invite status:
0: not connected (no active invite or invite was canceled)
1: pending (invite sent but not yet accepted)
2: connected (connected to your organization)
Disconnect from network
For any reason, a vendor or customer can be disconnected from your organization's network.
- DisconnectVendorFromNetwork - disconnects vendor from organization. The vendor is still part of the Bill.com network. Action cannot be undone. If vendor must be re-connected, use a new SendInvite call (if the vendor is still in the Bill.com network). Otherwise, use a new SendVendorInvite call.
- DisconnectCustomerFromNetwork - disconnects customer from organization. Action cannot be undone. If vendor must be re-connected, a new SendInvite call must be made.