Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

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.

System behaviours

  • 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.
  • 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
  • Once an ASN is confirmed (GRN sent), the ASN is closed. No further GRN's will be sent for this ASN.
  • In a CSV file, if you have a multi line ASN, the details of the ASN (Warehouse ETA, ASN Number, etc.), but be included on every row.

...


API

FTP

Manual

XML

x

x


JSON

x



CSV


x

x

 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. Typically one ASN per delivery (this may be a split of a PO).

nvarchar(50)


Mandatory


13/GRN/DeliveryNumber

HBReference

"House Bill" number. Open reference field. If no HBReference provided, ASNNumber populates this field. Must be unique. 

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)





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.

ASN number must be unique in the system.

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




...