Connectors Reference

Zahara

Zahara is a complete purchase management platform enabling paperless approvals for supplier invoices and purchase requisition.

 

Status: Preview

Tier: Premium

Version: v1

 

Actions:

Name

Summary

CreateDraftInvoice (string SenderEmail, string RecipientEmail, [Optional]string RaisedDate, [Optional]file File)

Create Draft Invoice

CreateInvoice (InvoiceAddIntegrationModel model)

Create Invoice

CreatePurchaseOrder (PurchaseOrderAddIntegrationModel model)

Create Purchase Order

CreateSupplier (SupplierAddIntegrationModel model)

Create Supplier

UpdateSupplier (integer id, SupplierAmendIntegrationModel model)

Update Supplier

 

Triggers:

Name

Summary

NewCostCode ()

New Cost Code

NewApprovalComment ()

New Approval Comment

NewDocumentApproved (string documentType)

New Document Approved

NewInvoice ()

New Invoice

NewInvoiceSetAsExported ()

New Invoice Set as Exported

NewNominalCode ()

New Nominal Code

NewProject ()

New Project

NewPurchaseOrder ()

New Purchase Order

NewPurchaseOrderSentToSupplier ()

New Purchase Order Sent to Supplier

NewPurchaseRequsition ()

New Purchase Requsition

NewSupplier ()

New Supplier

SupplierAmended ()

Supplier Amended

NewTaxCode ()

New Tax Code

 

Objects:

Name

Summary

AddressIntegrationModel

 

CostCodeIntegrationModel

 

DocumentSimpleIntegrationModel

 

file

File to upload

InvoiceAddIntegrationModel

 

InvoiceIntegrationModel

 

LineItemAddIntegrationModel

 

LineItemIntegrationModel

 

NominalCodeIntegrationModel

 

ProcessLogIntegrationModel

 

ProjectIntegrationModel

 

PurchaseOrderAddIntegrationModel

 

PurchaseOrderIntegrationModel

 

PurchaseRequsitionIntegrationModel

 

SupplierAddIntegrationModel

 

SupplierAmendIntegrationModel

 

SupplierIntegrationModel

 

SupplierSimpleIntegrationModel

 

SupplierUpdateIntegrationModel

 

TaxCodeIntegrationModel

 

UpdateSupplierResponse

 

UserIntegrationModel

 

 

Actions:

CreateDraftInvoice

Summary: Create Draft Invoice

Description: Creates a new draft invoice.

 

Syntax:

Zahara.CreateDraftInvoice (string SenderEmail, string RecipientEmail, [Optional]string RaisedDate, [Optional]file File)

 

Parameters:

Name

Type

Summary

Required

Related Action

SenderEmail

string

(Sender Email)

Sender Email

True

RecipientEmail

string

(Receiver Email)

Receiver Email

True

RaisedDate

string(date-time)

(Date when invoice was raised)

Date

False

File

file

(File to upload)

File to upload

False

 

Returns:

          Type:integer(int64)

 

CreateInvoice

Summary: Create Invoice

Description: Creates a new invoice.

 

Syntax:

Zahara.CreateInvoice (InvoiceAddIntegrationModel model)

 

Parameters:

Name

Type

Summary

Required

Related Action

model

InvoiceAddIntegrationModel

 

 

True

 

Returns:

          Type:integer(int64)

 

CreatePurchaseOrder

Summary: Create Purchase Order

Description: Creates a new purchase order.

 

Syntax:

Zahara.CreatePurchaseOrder (PurchaseOrderAddIntegrationModel model)

 

Parameters:

Name

Type

Summary

Required

Related Action

model

PurchaseOrderAddIntegrationModel

 

 

True

 

Returns:

          Type:integer(int64)

 

CreateSupplier

Summary: Create Supplier

Description: Creates a new supplier.

 

Syntax:

Zahara.CreateSupplier (SupplierAddIntegrationModel model)

 

Parameters:

Name

Type

Summary

Required

Related Action

model

SupplierAddIntegrationModel

 

 

True

 

Returns:

          Type:integer(int64)

 

UpdateSupplier

Summary: Update Supplier

Description: Updates an existing supplier.

 

Syntax:

Zahara.UpdateSupplier (integer id, SupplierAmendIntegrationModel model)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer(int64)

(Id of supplier to update)

Id of supplier to update

True

model

SupplierAmendIntegrationModel

 

 

True

 

Returns:

          Type:UpdateSupplierResponse

 

Triggers:

Trigger NewCostCode

Summary: New Cost Code

Description: When a new cost code is created.

 

Syntax:

Zahara.NewCostCode ()

 

Returns:

          Type:array of (CostCodeIntegrationModel)

 

Trigger NewApprovalComment

Summary: New Approval Comment

Description: When a new approval comment is added at a step.

 

Syntax:

Zahara.NewApprovalComment ()

 

Returns:

          Type:array of (ProcessLogIntegrationModel)

 

Trigger NewDocumentApproved

Summary: New Document Approved

Description: When a new document is approved.

 

Syntax:

Zahara.NewDocumentApproved (string documentType)

 

Parameters:

Name

Type

Summary

Required

Related Action

documentType

string

(Document type)Values: [PurchaseOrder, Invoice, PurchaseRequisition]

Determines what kind of document it is

True

 

Returns:

          Type:array of (ProcessLogIntegrationModel)

 

Trigger NewInvoice

Summary: New Invoice

Description: When a new invoice is created.

 

Syntax:

Zahara.NewInvoice ()

 

Returns:

          Type:array of (InvoiceIntegrationModel)

 

Trigger NewInvoiceSetAsExported

Summary: New Invoice Set as Exported

Description: When a new invoice is set as exported.

 

Syntax:

Zahara.NewInvoiceSetAsExported ()

 

Returns:

          Type:array of (InvoiceIntegrationModel)

 

Trigger NewNominalCode

Summary: New Nominal Code

Description: When a new nominal code is created.

 

Syntax:

Zahara.NewNominalCode ()

 

Returns:

          Type:array of (NominalCodeIntegrationModel)

 

Trigger NewProject

Summary: New Project

Description: When a new project is created.

 

Syntax:

Zahara.NewProject ()

 

Returns:

          Type:array of (ProjectIntegrationModel)

 

Trigger NewPurchaseOrder

Summary: New Purchase Order

Description: When a new purchase order is created.

 

Syntax:

Zahara.NewPurchaseOrder ()

 

Returns:

          Type:array of (PurchaseOrderIntegrationModel)

 

Trigger NewPurchaseOrderSentToSupplier

Summary: New Purchase Order Sent to Supplier

Description: When a new purchase order is sent to supplier.

 

Syntax:

Zahara.NewPurchaseOrderSentToSupplier ()

 

Returns:

          Type:array of (PurchaseOrderIntegrationModel)

 

Trigger NewPurchaseRequsition

Summary: New Purchase Requsition

Description: When a new purchase requsition is created.

 

Syntax:

Zahara.NewPurchaseRequsition ()

 

Returns:

          Type:array of (PurchaseRequsitionIntegrationModel)

 

Trigger NewSupplier

Summary: New Supplier

Description: When a new supplier is created.

 

Syntax:

Zahara.NewSupplier ()

 

Returns:

          Type:array of (SupplierIntegrationModel)

 

Trigger SupplierAmended

Summary: Supplier Amended

Description: When an existing supplier is updated.

 

Syntax:

Zahara.SupplierAmended ()

 

Returns:

          Type:array of (SupplierUpdateIntegrationModel)

 

Trigger NewTaxCode

Summary: New Tax Code

Description: When a new tax code is created.

 

Syntax:

Zahara.NewTaxCode ()

 

Returns:

          Type:array of (TaxCodeIntegrationModel)

 


 

AddressIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

AddressLines

string

 

 

Postcode

string

 

 

CountryCode

string

 

 


 

CostCodeIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

Id

integer(int64)

 

 

Code

string

 

 

Description

string

 

 

DateCreated

string(date-time)

 

 

IsActive

boolean

 

 


 

DocumentSimpleIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

DocumentNumber

string

 

 

Type

string

 

Values: [PurchaseOrder, Invoice, DeliveryNote, CreditNote, PurchaseRequisition]

Status

string

 

Values: [Created, Approved, Rejected, SentToSupplier, Completed, Closed, Draft, ExportOnHold, AdHocWorkflowNotFinished, SendToSupplierStepFailed]

DivisionName

string

 

 

CurrencyCode

string

 

 


 

file

Summary: File to upload

Description: File to upload

 

          Properties:

Name

Type

Summary


 

InvoiceAddIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

InvoiceNumber

string

 

 

PurchaseOrderNumber

string

 

 

RaisedDate

string(date-time)

 

 

DueDate

string(date-time)

 

 

SupplierReferenceNumber

string

 

 

Description

string

 

 

Comments

string

 

 

DivisionName

string

 

 

CurrencyCode

string

 

 

LineItems

array of (LineItemAddIntegrationModel)

 

 


 

InvoiceIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

DocumentNumber

string

 

 

PurchaseOrderNumber

string

 

 

TotalNetValue

number(double)

 

 

TotalGrossValue

number(double)

 

 

TotalTaxValue

number(double)

 

 

IsCreditNote

boolean

 

 

RaisedDate

string(date-time)

 

 

DueDate

string(date-time)

 

 

IsBasedOnAnyOrder

boolean

 

 

CurrentExportStatus

string

 

Values: [None, ReadyForExport, Exporting, ExportComplete, ExportFailed]

SyncDate

string(date-time)

 

 

SyncType

string

 

Values: [None, Csv, Sage50, Sage200, Xero, QuickBooks, MindYourOwnBusiness, SapBusinessByDesign, KashFlow, SmartInvoice, QuickBooksOnline]

BillingAddress

AddressIntegrationModel

 

 

DocumentId

integer(int64)

 

 

Description

string

 

 

LastUpdated

string(date-time)

 

 

DateCreated

string(date-time)

 

 

DeliveryAddress

AddressIntegrationModel

 

 

Supplier

SupplierSimpleIntegrationModel

 

 

LineItems

array of (LineItemIntegrationModel)

 

 

Type

string

 

Values: [PurchaseOrder, Invoice, DeliveryNote, CreditNote, PurchaseRequisition]

Status

string

 

Values: [Created, Approved, Rejected, SentToSupplier, Completed, Closed, Draft, ExportOnHold, AdHocWorkflowNotFinished, SendToSupplierStepFailed]

DivisionName

string

 

 

CurrencyCode

string

 

 


 

LineItemAddIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

CostCode

string

 

 

Quantity

number(double)

 

 

Price

number(double)

 

 

LineDescription

string

 

 

NominalCode

string

 

 

TaxCode

string

 

 

TaxValue

number(double)

 

 

DiscountPercentage

number(double)

 

 

ProductCode

string

 

 

ProjectCode

string

 

 


 

LineItemIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

Quantity

number(double)

 

 

Description

string

 

 

NominalCode

string

 

 

TaxCode

string

 

 

TaxPercentage

number(double)

 

 

TaxValue

number(double)

 

 

DiscountPercentage

number(double)

 

 

NetValue

number(double)

 

 

QuantityReceived

number(double)

 

 

ProductCode

string

 

 

GrossValue

number(double)

 

 

IsEmpty

boolean

 

 

CostCode

string

 

 

Price

number(double)

 

 

ProjectCode

string

 

 

SupplierName

string

 

 

ReferenceNumber

string

 

 


 

NominalCodeIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

Id

integer(int64)

 

 

Code

string

 

 

Description

string

 

 

IsActive

boolean

 

 

DateCreated

string(date-time)

 

 


 

ProcessLogIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

ProcessToken

string(uuid)

 

 

StepResult

string

 

Values: [None, Success, Failure, WaitForAction, ToReprocess, ProcessingWait, FailedToSendToSupplier]

Message

string

 

 

Approved

boolean

 

 

ActionDate

string(date-time)

 

 

DateCreated

string(date-time)

 

 

Comment

string

 

 

Document

DocumentSimpleIntegrationModel

 

 

ApprovedBy

UserIntegrationModel

 

 


 

ProjectIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

Id

integer(int64)

 

 

ProjectName

string

 

 

ProjectCode

string

 

 

Description

string

 

 

Start

string(date-time)

 

 

End

string(date-time)

 

 

Status

string

 

Values: [Active, Inactive, OnHold, Completed]

DateCreated

string(date-time)

 

 


 

PurchaseOrderAddIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

RequisitorName

string

 

 

RequiredDate

string(date-time)

 

 

SupplierReferenceNumber

string

 

 

Description

string

 

 

Comments

string

 

 

DivisionName

string

 

 

CurrencyCode

string

 

 

LineItems

array of (LineItemAddIntegrationModel)

 

 


 

PurchaseOrderIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

DocumentNumber

string

 

 

RequiredDate

string(date-time)

 

 

TotalNetValue

number(double)

 

 

TotalGrossValue

number(double)

 

 

TotalTaxValue

number(double)

 

 

SupplierComment

string

 

 

SentToSupplier

boolean

 

 

EverSentToSupplier

boolean

 

 

AcceptedBySupplier

boolean

 

 

ReportStatus

string

 

 

IsFullyReceived

boolean

 

 

IsReceivedInExcess

boolean

 

 

IsNotReceivedAtAll

boolean

 

 

Requisitor

UserIntegrationModel

 

 

DocumentId

integer(int64)

 

 

Description

string

 

 

LastUpdated

string(date-time)

 

 

DateCreated

string(date-time)

 

 

DeliveryAddress

AddressIntegrationModel

 

 

Supplier

SupplierSimpleIntegrationModel

 

 

LineItems

array of (LineItemIntegrationModel)

 

 

Type

string

 

Values: [PurchaseOrder, Invoice, DeliveryNote, CreditNote, PurchaseRequisition]

Status

string

 

Values: [Created, Approved, Rejected, SentToSupplier, Completed, Closed, Draft, ExportOnHold, AdHocWorkflowNotFinished, SendToSupplierStepFailed]

DivisionName

string

 

 

CurrencyCode

string

 

 


 

PurchaseRequsitionIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

DocumentNumber

string

 

 

RequiredDate

string(date-time)

 

 

TotalNetValue

number(double)

 

 

TotalGrossValue

number(double)

 

 

UsersToNotify

string

 

 

WasPoGenerated

boolean

 

 

Requisitor

UserIntegrationModel

 

 

DocumentId

integer(int64)

 

 

Description

string

 

 

LastUpdated

string(date-time)

 

 

DateCreated

string(date-time)

 

 

DeliveryAddress

AddressIntegrationModel

 

 

Supplier

SupplierSimpleIntegrationModel

 

 

LineItems

array of (LineItemIntegrationModel)

 

 

Type

string

 

Values: [PurchaseOrder, Invoice, DeliveryNote, CreditNote, PurchaseRequisition]

Status

string

 

Values: [Created, Approved, Rejected, SentToSupplier, Completed, Closed, Draft, ExportOnHold, AdHocWorkflowNotFinished, SendToSupplierStepFailed]

DivisionName

string

 

 

CurrencyCode

string

 

 


 

SupplierAddIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

AddressLines

string

 

 

ContactName

string

 

 

CountryCode

string

 

 

Email

string

 

 

PostCode

string

 

 

ReferenceNumber

string

 

 

SupplierName

string

 

 

Telephone

string

 

 

Type

string

 

 


 

SupplierAmendIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

Id

integer(int64)

 

 

AddressLines

string

 

 

ContactName

string

 

 

CountryCode

string

 

 

Email

string

 

 

PostCode

string

 

 

ReferenceNumber

string

 

 

SupplierName

string

 

 

Telephone

string

 

 

Type

string

 

 


 

SupplierIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

Id

integer(int64)

 

 

ContactName

string

 

 

Email

string

 

 

LastUpdated

string(date-time)

 

 

DateCreated

string(date-time)

 

 

Telephone

string

 

 

VatReg

string

 

 

DefaultNominalCode

string

 

 

DefaultTaxCode

string

 

 

DefaultCostCode

string

 

 

DefaultPaymentTerms

integer(int32)

 

 

Notes

string

 

 

Terms

string

 

 

Type

string

 

 

IsActive

boolean

 

 

Address

AddressIntegrationModel

 

 

SupplierName

string

 

 

ReferenceNumber

string

 

 


 

SupplierSimpleIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

SupplierName

string

 

 

ReferenceNumber

string

 

 


 

SupplierUpdateIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

OriginalId

integer(int64)

 

 

Id

integer(int64)

 

 

ContactName

string

 

 

Email

string

 

 

LastUpdated

string(date-time)

 

 

DateCreated

string(date-time)

 

 

Telephone

string

 

 

VatReg

string

 

 

DefaultNominalCode

string

 

 

DefaultTaxCode

string

 

 

DefaultCostCode

string

 

 

DefaultPaymentTerms

integer(int32)

 

 

Notes

string

 

 

Terms

string

 

 

Type

string

 

 

IsActive

boolean

 

 

Address

AddressIntegrationModel

 

 

SupplierName

string

 

 

ReferenceNumber

string

 

 


 

TaxCodeIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

Id

integer(int64)

 

 

Code

string

 

 

CodeName

string

 

 

TaxPercentage

number(double)

 

 

Display

boolean

 

 

DateCreated

string(date-time)

 

 


 

UpdateSupplierResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary


 

UserIntegrationModel

Summary:

Description:

 

          Properties:

Name

Type

Summary

UserName

string

 

 

Email

string

 

 

JobTitle

string

 

 

TelephoneNumber

string