Dcove
  1. master
Dcove
  • master
    • Stores**
      POST
    • Article Batches
      POST
    • Article Eans
      POST
    • Article Master**
      POST
    • Article Supplier Mapping**
      POST
    • DC - Store Mapping**
      POST
    • Manufacturer
      POST
    • Purchase Returns
      POST
    • Wastages
      POST
    • Supplier Master**
      POST
    • Supplier Contacts
      POST
    • Production Pipeline Execution
      POST
    • Kit Master
      POST
    • Bulk Repack Master
      POST
    • Article Uom Master
      POST
    • Supplier WalkIns
      POST
    • Article Pricing Master
      POST
    • Article Store Limits
      POST
    • Current Stock**
      POST
    • Stores As Suppliers
      POST
    • Stock Location**
      POST
    • Customer Master
      POST
    • Company Group
      POST
    • Hierarchy Headers**
      POST
    • Hierarchy Details**
      POST
    • Article Hierarchy**
      POST
    • Article Attributes
      POST
    • ArticleGateKeeperMargin
      POST
  • transactional
    • Stock Ledger**
    • Bill Header**
    • Bill Detail**
    • Invoices Header**
    • Invoices Detail**
    • Supplier Invoice Acknowledgement
    • Purchase Order Header**
    • Purchase Order Detail
    • Transfer In Header**
    • Transfer In Detail**
    • Transfer Out Header**
    • Transfer Out Detail**
    • Transfer Advice Header
    • Transfer Advice Detail
  1. master

Purchase Returns

POST
/master/purchase_returns/
master
Tracks returns to the suppliers.

Request

Header Params
X-SYNC-TOKEN
string 
required

<sync_token>

Accept-Encoding
string 
required
gzip (mandatory)
Body Params application/json
array of:
pr_id
string 
required
article_id
string 
required
store_id
string 
required
supplier_id
string 
required
return_date
string <date>
required
Date of creation for the return
received_grn_id
string 
required
quantity
number <double>
required
Total return quantity.
unitary_cp_without_tax
number <double>
required
tax_perc
number <double>
required
mrp
number <double>
required
status
enum<string> 
optional
Allowed values:
cancelledclosedopen
adjusted_no
string 
required
Identification number for the adjustment.
adjusted_date
string <date>
required
Date on which adjustment is completed.
batch_no
string 
required
Batch id for the article.
Example
[
  {
    "pr_id": "string",
    "article_id": "string",
    "store_id": "string",
    "supplier_id": "string",
    "return_date": "2019-08-24",
    "received_grn_id": "string",
    "quantity": 0,
    "unitary_cp_without_tax": 0,
    "tax_perc": 0,
    "mrp": 0,
    "status": "cancelled",
    "adjusted_no": "string",
    "adjusted_date": "2019-08-24",
    "batch_no": "string"
  }
]

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test.your-api-server.com/master/purchase_returns/' \
--header 'X-SYNC-TOKEN;' \
--header 'Accept-Encoding;' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "pr_id": "string",
        "article_id": "string",
        "store_id": "string",
        "supplier_id": "string",
        "return_date": "2019-08-24",
        "received_grn_id": "string",
        "quantity": 0,
        "unitary_cp_without_tax": 0,
        "tax_perc": 0,
        "mrp": 0,
        "status": "cancelled",
        "adjusted_no": "string",
        "adjusted_date": "2019-08-24",
        "batch_no": "string"
    }
]'

Responses

🟢200OK
application/json
Successful Sync
Body
status
string 
optional
message
string 
optional
Example
{
  "status": "string",
  "message": "string"
}
🟠403Forbidden
🟠405405
Modified at 2025-02-10 12:39:04
Previous
Manufacturer
Next
Wastages
Built with