Retail Express API 2.1

Creates Supplier Return Item

Sample request:

 POST /supplierreturns/1/supplierreturnitems
 {
     "product": {
         "id": 1
     },
     "supplier_return_reason": {
         "id": 1
     },
     "return_quantity": 1,
     "original_buy_ex": 1.1,
     "claim_amount_ex": 1.1,
     "supplier_return_item_source": {
          "id": 1
     },
     "original_supplier_invoice": "original supplier invoice",
     "supplier_return_item_notes": "notes"
 }
post
https://api.retailexpress.com.au/v2.1/supplierreturns/{id}/supplierreturnitems

Path Parameters

idinteger(int32)required

Supplier Return id

Headers

x-api-keystringrequired

Api subscription key

Cache-Controlstring

Default:no-cache

Authorizationstringrequired

Bearer token for authorization (e.g., Bearer )

Body

application/json

Supplier Return Item to be created

EmptyExample

EmptyExampleobject
* Additional properties are NOT allowed.

Response

application/json

Supplier Return Item was created

SupplierReturnItem

Supplier Return Item

* Additional properties are NOT allowed.
idinteger(int32)

Supplier Return Item identifier

supplier_return_idinteger(int32)

Supplier Return id

productobject

Supplier Return Item Product Model

* Additional properties are NOT allowed.
Show Child Parameters
supplier_return_reasonobject

Supplier Return Reason model

* Additional properties are NOT allowed.
Show Child Parameters
credit_note_itemobject
* Additional properties are NOT allowed.
Show Child Parameters
return_quantityinteger | null(int32)

Return Quantity

original_buy_exnumber | null(double)

Supplier price ex

total_original_buy_exnumber | null(double)

Total supplier buy ex

supplier_return_item_statusobject

Supplier Return Item Status Model

* Additional properties are NOT allowed.
Show Child Parameters
supplier_return_item_sourceobject

Supplier Return Item Product Model

* Additional properties are NOT allowed.
Show Child Parameters
original_supplier_invoicestring | null

Supplier invoice number

claim_amount_exnumber | null(double)

Claim amount ex

supplier_return_item_notesstring | null

Notes

total_claim_amount_exnumber | null(double)

Total claim amount ex

total_claim_amount_taxnumber | null(double)

Total claim amount tax

total_claim_amount_incnumber | null(double)

Total claim amount inc

created_onstring(date-time)

Created on

modified_onstring(date-time)

Modified on

created_byobject
* Additional properties are NOT allowed.
Show Child Parameters
modified_byobject
* Additional properties are NOT allowed.
Show Child Parameters
post/supplierreturns/{id}/supplierreturnitems

Body

{}
 
application/json

Get specific Supplier Return Item by Supplier Return id and Supplier Return Item id

Get specific Supplier Return Item by Supplier Return id and Supplier Return Item id

get
https://api.retailexpress.com.au/v2.1/supplierreturns/{id}/supplierreturnitems/{item_id}

Path Parameters

idinteger(int32)required

Supplier Return id

item_idinteger(int32)required

Supplier Return Item id

Headers

x-api-keystringrequired

Api subscription key

Cache-Controlstring

Default:no-cache

Authorizationstringrequired

Bearer token for authorization (e.g., Bearer )

Response

application/json

Returns found Supplier Return Item

SupplierReturnItem

Supplier Return Item

* Additional properties are NOT allowed.
idinteger(int32)

Supplier Return Item identifier

supplier_return_idinteger(int32)

Supplier Return id

productobject

Supplier Return Item Product Model

* Additional properties are NOT allowed.
Show Child Parameters
supplier_return_reasonobject

Supplier Return Reason model

* Additional properties are NOT allowed.
Show Child Parameters
credit_note_itemobject
* Additional properties are NOT allowed.
Show Child Parameters
return_quantityinteger | null(int32)

Return Quantity

original_buy_exnumber | null(double)

Supplier price ex

total_original_buy_exnumber | null(double)

Total supplier buy ex

supplier_return_item_statusobject

Supplier Return Item Status Model

* Additional properties are NOT allowed.
Show Child Parameters
supplier_return_item_sourceobject

Supplier Return Item Product Model

* Additional properties are NOT allowed.
Show Child Parameters
original_supplier_invoicestring | null

Supplier invoice number

claim_amount_exnumber | null(double)

Claim amount ex

supplier_return_item_notesstring | null

Notes

total_claim_amount_exnumber | null(double)

Total claim amount ex

total_claim_amount_taxnumber | null(double)

Total claim amount tax

total_claim_amount_incnumber | null(double)

Total claim amount inc

created_onstring(date-time)

Created on

modified_onstring(date-time)

Modified on

created_byobject
* Additional properties are NOT allowed.
Show Child Parameters
modified_byobject
* Additional properties are NOT allowed.
Show Child Parameters
get/supplierreturns/{id}/supplierreturnitems/{item_id}
 
application/json

Deletes specific Supplier Return Item by id

Deletes specific Supplier Return Item by id

delete
https://api.retailexpress.com.au/v2.1/supplierreturns/{id}/supplierreturnitems/{item_id}

Path Parameters

idinteger(int32)required

Supplier Return Id

item_idinteger(int32)required

Supplier Return Item Id

Headers

x-api-keystringrequired

Api subscription key

Cache-Controlstring

Default:no-cache

Authorizationstringrequired

Bearer token for authorization (e.g., Bearer )

Response

Supplier Return Item was deleted

delete/supplierreturns/{id}/supplierreturnitems/{item_id}
 

Updates Supplier Return Item

Sample request:

 PUT /supplierreturns/1/supplierreturnitems/1
 {
     "product": {
         "id": 1
     },
     "supplier_return_reason": {
         "id": 1
     },
     "return_quantity": 1,
     "original_buy_ex": 1.1,
     "claim_amount_ex": 1.1,
     "supplier_return_item_status": {
         "id": 1
     },
     "supplier_return_item_source": {
          "id": 1
     },
     "original_supplier_invoice": "original supplier invoice",
     "supplier_return_item_notes": "notes"
  }
put
https://api.retailexpress.com.au/v2.1/supplierreturns/{id}/supplierreturnitems/{item_id}

Path Parameters

idinteger(int32)required

Supplier Return id

item_idinteger(int32)required

Supplier Return Item id

Headers

x-api-keystringrequired

Api subscription key

Cache-Controlstring

Default:no-cache

Authorizationstringrequired

Bearer token for authorization (e.g., Bearer )

Body

application/json

Supplier Return Item model

EmptyExample

EmptyExampleobject
* Additional properties are NOT allowed.

Response

application/json

Returns updated Supplier Return Item

SupplierReturnItem

Supplier Return Item

* Additional properties are NOT allowed.
idinteger(int32)

Supplier Return Item identifier

supplier_return_idinteger(int32)

Supplier Return id

productobject

Supplier Return Item Product Model

* Additional properties are NOT allowed.
Show Child Parameters
supplier_return_reasonobject

Supplier Return Reason model

* Additional properties are NOT allowed.
Show Child Parameters
credit_note_itemobject
* Additional properties are NOT allowed.
Show Child Parameters
return_quantityinteger | null(int32)

Return Quantity

original_buy_exnumber | null(double)

Supplier price ex

total_original_buy_exnumber | null(double)

Total supplier buy ex

supplier_return_item_statusobject

Supplier Return Item Status Model

* Additional properties are NOT allowed.
Show Child Parameters
supplier_return_item_sourceobject

Supplier Return Item Product Model

* Additional properties are NOT allowed.
Show Child Parameters
original_supplier_invoicestring | null

Supplier invoice number

claim_amount_exnumber | null(double)

Claim amount ex

supplier_return_item_notesstring | null

Notes

total_claim_amount_exnumber | null(double)

Total claim amount ex

total_claim_amount_taxnumber | null(double)

Total claim amount tax

total_claim_amount_incnumber | null(double)

Total claim amount inc

created_onstring(date-time)

Created on

modified_onstring(date-time)

Modified on

created_byobject
* Additional properties are NOT allowed.
Show Child Parameters
modified_byobject
* Additional properties are NOT allowed.
Show Child Parameters
put/supplierreturns/{id}/supplierreturnitems/{item_id}

Body

{}
 
application/json

Creates Credit Note with Credit Note Items

Sample request:

 POST /supplierreturns/{id}/creditnotes
 {
     "supplier_reference": "supplier_reference",
     "supplier_credited_on": "2022-11-18",
     "credit_note_items": [
          {
              "supplier_return_item_id": 1
          },
          {
              "supplier_return_item_id": 2
          }
     ]
 }
post
https://api.retailexpress.com.au/v2.1/supplierreturns/{id}/creditnotes

Path Parameters

idinteger(int32)required

Supplier Return id

Headers

x-api-keystringrequired

Api subscription key

Cache-Controlstring

Default:no-cache

Authorizationstringrequired

Bearer token for authorization (e.g., Bearer )

Body

application/json

Credit Note to be created

EmptyExample

EmptyExampleobject
* Additional properties are NOT allowed.

Response

application/json

Credit Note model with Credit Note Items were created

SupplierReturnsCreditNote

Credit Note model for ​/supplierreturn​/{id}​/creditnotes endpoint

* Additional properties are NOT allowed.
idinteger | null(int32)

Credit Note id

supplier_return_idinteger | null(int32)

Supplier Return id

supplierobject
* Additional properties are NOT allowed.
Show Child Parameters
outletobject
* Additional properties are NOT allowed.
Show Child Parameters
supplier_referencestring | null

Supplier reference

>= 0 characters<= 50 characters

include_taxboolean | null

Include tax

Default:false

rounding_adjustmentnumber(double)

Rounding Adjustment

total_credit_quantityinteger(int32)

Total credit quantity

total_credit_amount_exnumber(double)

Total Credit Amount Ex

total_credit_amount_taxnumber(double)

Total Credit Amount Tax

total_credit_amount_incnumber(double)

Total Credit Amount Inc

total_applied_credit_quantityinteger(int32)

Total Applied Credit Quantity

total_applied_credit_amount_exnumber(double)

Total Applied Credit Amount Ex

total_applied_credit_amount_incnumber(double)

Total Applied Credit Amount Inc

total_applied_credit_taxnumber(double)

Total Applied Credit Tax

credit_note_itemsarray | null[object]

List of Credit Note items

* Additional properties are NOT allowed.
Show Child Parameters
created_onstring(date-time)

Created on

modified_onstring(date-time)

Modified on

supplier_credited_onstring | null(date-time)

Supplier Credited On

created_byobject
* Additional properties are NOT allowed.
Show Child Parameters
modified_byobject
* Additional properties are NOT allowed.
Show Child Parameters
post/supplierreturns/{id}/creditnotes

Body

{}
 
application/json