Sample code for 30+ languages & platforms
Xbase++ Requires Chilkat v11.0.0+

Xero Upload Attachment

See more Xero Examples

Demonstrates how to upload an attachment to Xero.

Chilkat Xbase++ Downloads

Xbase++
LOCAL nSuccess
LOCAL oHttp
LOCAL oJsonToken
LOCAL cUrl
LOCAL oBd
LOCAL oResp
LOCAL oJsonResponse

nSuccess := 0

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

oHttp := CreateObject("Chilkat.Http")

//  Important: Make sure your OAuth2 access token was obtained with the scope "accounting.attachments"
//  included in the list of scopes.

oJsonToken := CreateObject("Chilkat.JsonObject")
nSuccess := oJsonToken:LoadFile("qa_data/tokens/xero-access-token.json")
IF (nSuccess == 0)
    ? oJsonToken:LastErrorText
    oHttp:destroy()
    oJsonToken:destroy()
    RETURN
ENDIF

oHttp:AuthToken := oJsonToken:StringOf("access_token")

//  Replace the value here with an actual tenant ID obtained from this example:
//  Get Xero Tenant IDs
oHttp:SetRequestHeader("Xero-tenant-id", "83299b9e-5747-4a14-a18a-a6c94f824eb7")

oHttp:Accept := "application/json"

cUrl := "https://api.xero.com/api.xro/2.0/{$Endpoint}/{$Guid}/Attachments/{$Filename}"

//  Endpoint can be Invoices, Receipts, CreditNotes, PurchaseOrders, etc.
oHttp:SetUrlVar("Endpoint", "Invoices")

//  Guid is the ID of the item, such as the InvoiceID.
oHttp:SetUrlVar("Guid", "0032f627-3156-4d30-9b1c-4d3b994dc921")

//  Filename is the filename of the attachment you are uploading.
oHttp:SetUrlVar("Filename", "penguins.jpg")

//  Load the file to be uploaded (from the local filesystem).
oBd := CreateObject("Chilkat.BinData")
nSuccess := oBd:LoadFile("qa_data/jpg/penguins.jpg")
IF (nSuccess == 0)
    ? "Failed to load attachment file."
    oHttp:destroy()
    oJsonToken:destroy()
    oBd:destroy()
    RETURN
ENDIF

//  Indicate the content-type according to the file content type.
//  Common content-types are:   image/jpg, image/png, application/pdf, application/zip, application/msword
//  If you don't know, use application/octet-stream
oResp := CreateObject("Chilkat.HttpResponse")
nSuccess := oHttp:HttpBd("POST", cUrl, oBd, "image/jpg", oResp)
IF (nSuccess == 0)
    ? oHttp:LastErrorText
    oHttp:destroy()
    oJsonToken:destroy()
    oBd:destroy()
    oResp:destroy()
    RETURN
ENDIF

? "Response Status Code: " + Str(oResp:StatusCode)

oJsonResponse := CreateObject("Chilkat.JsonObject")
oJsonResponse:Load(oResp:BodyStr)
oJsonResponse:EmitCompact := 0
? oJsonResponse:Emit()

IF (oResp:StatusCode != 200)
    ? "Failed."
    oHttp:destroy()
    oJsonToken:destroy()
    oBd:destroy()
    oResp:destroy()
    oJsonResponse:destroy()
    RETURN
ENDIF

//  A sample response:

//  Use this online tool to generate parsing code from sample JSON: 
//  Generate Parsing Code from JSON

//  {
//    "Id": "35333c64-4449-457b-bf6a-1b64d538e3c7",
//    "Status": "OK",
//    "ProviderName": "Chilkat2222",
//    "DateTimeUTC": "\/Date(1587212597758)\/",
//    "Attachments": [
//      {
//        "AttachmentID": "daf106e2-8634-4349-bfcc-86c1df0793b2",
//        "FileName": "penguins.jpg",
//        "Url": "https://api.xero.com/api.xro/2.0/Invoices/0032f627-3156-4d30-9b1c-4d3b994dc921/Attachments/penguins.jpg",
//        "MimeType": "image/jpg",
//        "ContentLength": 777835
//      }
//    ]
//  }

oHttp:destroy()
oJsonToken:destroy()
oBd:destroy()
oResp:destroy()
oJsonResponse:destroy()