MailInvoice – Developer Support

About MailInvoice

If your Customer is not part of the Bill.com network, use this call to send invoices via US mail.

The specified invoice will be printed and mailed from Bill.com to the Customer. On the Bill.com UI, this is applied on the Invoice option to "Send via US Mail".

Key points:

Customer details required:

Country must be United States
Mandatory fields: city, state and zip code

Allow 3-5 business days for mail to reach recipient.
In case mail cannot be delivered, your Organization details (Company Profile) must include your location (address, city, state, zip).

Example

Request

<API_URL_EndPoint>/MailInvoice.json

data={
   "invoiceId" : "00e01QPOLXQSSFRIUak6"
}

Response

{
  "response_status" : 0,
  "response_message" : "Success",
  "response_data" : {
  }
}

Response (failure)

Customer billing address is outside US:

{
  "response_status" : 1,
  "response_message" : "Error",
  "response_data" : {
    "error_code" : "BDC_1333",
    "error_message" : "Cannot send via US Mail now because customer mailing address is a Non US address."
  }
}

Incomplete customer mailing address:

{
  "response_status" : 1,
  "response_message" : "Error",
  "response_data" : {
    "error_code" : "BDC_1332",
    "error_message" :"Cannot send via US Mail now because customer mailing address is incomplete. Update the customer address with a valid US address and try again."
  }
}

Permissions

User must have role permission to manage invoice. The sync token can also use this API.
The Bill.com Account Receivables module must be enabled. Free receivables accounts cannot use this API.

Resources

Parameters

Field Name	Description	Required?
invoiceId	Id of invoice to be mailed.	Yes