Outbound | POST | {Client’s URL}
Summary
This API sends near real-time GRN Notifications to ERP with gate entry level data. The feature will help to keep the ERP systems notified about all the GRN’s happening for a client.
Description
This API sends all the GRN notification gate-entry wise for the orders for which items have been GRN’ed since the time the job last ran and synced notifications successfully to ERP. Frequency of this job is configurable.
Request
Code Block | ||
---|---|---|
| ||
{
"invoiceId": 1234,
"invoiceDocumentUrl": "https://www.increff.com/invoiceUrl",
"stateTaxDocumentUrl": "https://www.increff.com/staxDocurl",
"shippingLabelDocumentUrl": "https://www.increff.com/slurl",
"transporter": "BlueDart",
"vehicleNumber": "KA90-87-01",
"invoiceCode": "invoiceCode",
"gateEntryCreatedAt": "2020-10-16T20:22:28.000+00:00",
"externalInvoiceDate": "2020-10-16T20:22:28.000+00:00",
"awbNumber": "awbNumber",
"gateEntryId": 1234,
"messageId": 1001,
"orderCode": "po123",
"orderType": "PO/STO/RO",
"locationCode": "l123",
"billOfEntry": "b123",
"entryDeclarationNumber": "en1",
"parentOrderCode": "pOrder123",
"partnerCode": "partner1",
"partnerLocationCode": "partnerLoc1",
"asnCode": null,
"generatedAsnId": null,
"items": [{
"orderItemCode": "oc1",
"channelSkuCode": "100005734",
"qcPassAbsoluteQuantity": 500,
"qcFailAbsoluteQuantity": 2,
"qcFailDeltaQuantity": 1,
"qcPassDeltaQuantity": 1,
"orderItemCustomAttributes": {
"attribute1": "Value1",
"attribute2": "Value2",
"attribute3": "Value3",
"attribute4": "Value4",
"attribute5": "Value5",
"attribute6": "Value6",
"attribute7": "Value7",
"attribute8": "Value8",
"attribute9": "Value9",
"attribute10": "Value10",
"channelMetadata": {
"totalCashOnDeliveryFee": 0.0,
"department": "HR",
"paymentMethod": "ccavenue",
"status": "processing"
}
}
},
{
"orderItemCode": null,
"channelSkuCode": "100005736",
"qcPassAbsoluteQuantity": 400,
"qcFailAbsoluteQuantity": 2,
"qcFailDeltaQuantity": 2,
"qcPassDeltaQuantity": 2,
"orderItemCustomAttributes": null
}
],
"orderCustomAttributes": {
"attribute1": "Value1",
"attribute2": "Value2",
"attribute3": "Value3",
"attribute4": "Value4",
"attribute5": "Value5",
"attribute6": "Value6",
"attribute7": "Value7",
"attribute8": "Value8",
"attribute9": "Value9",
"attribute10": "Value10",
"channelMetadata": {
"totalCashOnDeliveryFee": 0.0,
"department": "HR",
"paymentMethod": "ccavenue",
"status": "processing"
},
"currency": "INR"
}
} |
Parameter Name | Data Type | Description | Mandatory |
| String | External invoiceId provided at the time of Gate entry creation | Yes |
| Long | Internal invoiceId generated at the time of GRN | Yes |
| Long | Gate entry Id created at the time of GRN | Yes |
| String | Invoice document provided at the time of Gate entry creation is available via the Url | Yes |
| String | State tax document provided at the time of Gate entry creation is available via the Url | Yes |
| String | Shipping label document provided at the time of Gate entry creation is available via the Url | Yes |
| String | Transporter which delivered the goods to warehouse | Yes |
| String | Vehicle Number which delivered the goods to warehouse | Yes |
| String | Time at which gate entry was created in Increff Omni | Yes |
| String | Time at which order was placed at the channel in UNIX (UTC) | yes |
| String | Awb number of shipment which is getting inwarded | Yes |
| String | Unique code used by the channel to identify the order | Yes |
| String | Possible value - SO (Sales Order), STO (Stock Transfer Order), RTV (Return To Vendor), RPO(Replacement), PO, RO, OPEN_PO, OPEN_RO | Yes |
| String | Code used by channels to identify a warehouse | Yes |
| Long | Unique Identifier of a notification ( for de-duplication) | Yes |
| String | Bill of entry of GRN | no |
| String | Entry declaration number | no |
| String | Parent order code | yes |
| String | This represents the partner from which order will come. If Order is of type PO/STO, this field represents vendor's code If Order is of type RO, this field represents customer’s code | yes |
| String | This represents the partner’s location from which order will come. If Order is of type PO/STO, this field represents vendor location’s code If Order is of type RO, this field represents customer location’s code | Yes |
| String | External code for the corresponding ASN | no |
| String | Internal code for the corresponding ASN | no |
| Object[] | List of items being GRN’ed | Yes |
| String | Code of an item in a particular order | no |
| String | SKU code of order item | Yes |
| Integer | Total Qc pass quantity GRNed in order for the SKU | Yes |
| Integer | Total Qc fail quantity GRNed in order for the SKU | Yes |
| Integer | Qc pass quantity GRNed in order for the SKU since the last notification to ERP for the order. | Yes |
| Integer | Qc fail quantity GRNed in order for the SKU since the last notification to ERP for the order. | Yes |
| Object | Custom attributes for order items | No |
| String | Custom attribute 1 | No |
| String | Custom attribute 2 | No |
| String | Custom attribute 3 | No |
| String | Custom attribute 4 | No |
| String | Custom attribute 5 | No |
| String | Custom attribute 6 | No |
| String | Custom attribute 7 | No |
| String | Custom attribute 8 | No |
| String | Custom attribute 9 | No |
| String | Custom attribute 10 | No |
| Object | These are additonal fields which can be sent to Increff system and can be used in subsequent Posting workflows | No |
| Object | Custom attributes for an order | No |
| Object | These are additonal fields which can be sent to Increff system and can be used in subsequent Posting workflows | No |
| String | Currency | No |
| String | Custom attribute 1 | No |
| String | Custom attribute 2 | No |
| String | Custom attribute 3 | No |
| String | Custom attribute 4 | No |
| String | Custom attribute 5 | No |
| String | Custom attribute 6 | No |
| String | Custom attribute 7 | No |
| String | Custom attribute 8 | No |
| String | Custom attribute 9 | No |
| String | Custom attribute 10 | No |
Response
Code Block | ||
---|---|---|
| ||
{
"hasError":false,
"errorMessage":"message"
} |
HttpStatus : 200