Description |
This method can be called to create new receipts in SupplyStream, suitable for both standard deliveries and returns. This will create an advance ship notice of pending deliveries to the DC. |
...
- The Receipt is defined by the ASNNumber (Identifier)
- If one Line Item in the ASN returns an error (for example, 'Error Submitting Receipt: ASN030117 - Error. Product 4809019 does not exist.'), then the entire ASN fails to upload.
- An ASN cannot be edited once uploaded.
- If there are multiple lots of a single SKU, these will need to be separated out onto separate ASN's. A single ASN (defined by the ASN number) does not accept multiple lines of the same SKU.
- Within a single ASN, all lines need to be from the same supplier
Available formats
Supplier details management
This diagram shows how the SupplierCompanyCode field of this service can be used to assign a supplier to a SKU on an ASN. Otherwise, the value used can be the default supplier code which is assigned to all SKU's. You can have multiple suppliers to a product. Uploading additional suppliers using Load Product Master Updates does not overwrite previously assigned suppliers.
Entity Relationships
This diagram shows the high level relationship between the entities detailed in the Field Level Details section of this page.
Field level details
Receipt | ||||||
Field | Description | Data Type | Value Limits | Requirement | Use on standard documents | Field returned in service ID/table/field (multi services split by ";") |
ASNNumber | ASN reference identification code that allow the DC to identify the incoming goods. | nvarchar(50) | Mandatory | 13/GRN/DeliveryNumber | ||
HBReference | Open reference field. If no HBReference provided, ASNNumber populates this field. | nvarchar(50) | 13/GRN/HBRef | |||
WarehouseETA | The date in which the goods are expected to reach the DC. Other CSV date format options available at request. | datetime | CSV: dd/MM/YYYY e.g. 12/09/2016. Other: YYYY-MM-ddTHH:mm:ssZ e.g. 2013-10-31T00:00:00Z | |||
IsReturn | If this is a return delivery, mark this field as TRUE. If this is not specified, it will default as FALSE | boolean | true. false | Conditional: Set to TRUE if a return | ||
Notes | Note to DC. | nvarchar(4000) | ||||
ReceiptReasonCode | Placeholder. | nvarchar(50) | ||||
UpdateReceipt | The system will look for an existing ASN in status "Create" with the specified ASN Number. If this field is set to TRUE and the ASN Number already exists, the system will remove the existing record and create a new one in its place. This will also update the line items of the receipt. | boolean | ||||
ReceiptType | Mark whether the receipt is a Standard delivery, or a return. Use either the IsReturn field, or this one. They control the same data in SupplyStream. | nvarchar(100) | Standard, Return | |||
GUID | SupplyStream Globally Unique Identifier. If GUID not provided, this will be automatically generated by the system. System generated example: a99645dc-5b45-4917-890c-4b02c68ac342. Returned in API response message. Must be unique to the service. | varchar(100) | 13/GRN/ InterfaceRecordId |
...