Jegliches Änderung von Properties für SalesOrderItems kann nur für einzelne Properties vorgenommen werden.
Daher sind Änderungen ausschliesslich mit solchen Requests möglich:
PUT http://sandbox.api.via.de/publicapi/v1/api.svc/SalesOrderItems(1L)/Property
Jede Änderung auf ein ganzes Entity wird mit einem Error abgewiesen.
Beispiele für solche Requests finden Sie weiter unten.
Versandstatus setzen
Mit Setzen des Versandstatuses für SalesOrderItems kann man Teillieferungen definieren.
Sie können auch die Bestellung als versendet markieren.
Schauen Sie dazu in die Beispiele von
SalesOrdersRequest
Request Methode
PUT http://sandboxapi.via.de/publicapi/v1/api.svc/SalesOrderItems(1L)/ShippingStatus
Request-HTTP-Header
Content-Type: application/xml
SubscriptionToken: g93af799-6ae8-e111-8406-0050568261dc
Cookie: .ASPXAUTH=0186587E1743637D35632A7EDAF4F07EA67C6E4577770C3778FD9C17904A9D85B01369A8198B23A9AF530DBE93A68687C219BE1876B16B 0DAEBBD2C3318CA6C99D9C53E5B9FE17B7CF9661C5CDDDB97B90D5D3AF550100227EC8D6E6858FAE986AF2302C337B8DFEC6099898C19AA335A81317AB2B382DE72586AA9DF830C715332215AEBFD5E2FBA45F2BB5A7CA9793; path=/; HttpOnly
Request-Body
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ShippingStatus p1:type="Edm.Int32" xmlns:p1="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices">0</ShippingStatus>
Request-HTTP-Header
Content-Type: application/json
Accept: application/json
SubscriptionToken: g93af799-6ae8-e111-8406-0050568261dc
Cookie: .ASPXAUTH=0186587E1743637D35632A7EDAF4F07EA67C6E4577770C3778FD9C17904A9D85B01369A8198B23A9AF530DBE93A68687C219BE1876B16B 0DAEBBD2C3318CA6C99D9C53E5B9FE17B7CF9661C5CDDDB97B90D5D3AF550100227EC8D6E6858FAE986AF2302C337B8DFEC6099898C19AA335A81317AB2B382DE72586AA9DF830C715332215AEBFD5E2FBA45F2BB5A7CA9793; path=/; HttpOnly
Request-Body
{
"ShippingStatus" : "1"
}
Response HTTP-Header
Status Code: 204 No Content
Cache-Control: no-cache
DataServiceVersion: 1.0;
...
Produktdaten abrufen
Damit man eine Relation zu einem verkauften Artikel und einem bestehenden Produkt im Fremdsystem herstellen kann, kann man die verknüpften Produktdaten zu dem verkauftem Artikel abrufen.
Request Methode
GET http://sandboxapi.via.de/publicapi/v1/api.svc/SalesOrderItems(1L)/Product
Request HTTP-Header
Content-Type: application/atom+xml
SubscriptionToken: g93af799-6ae8-e111-8406-0050568261dc
Cookie: .ASPXAUTH=0186587E1743637D35632A7EDAF4F07EA67C6E4577770C3778FD9C17904A9D85B01369A8198B23A9AF530DBE93A68687C219BE1876B16B 0DAEBBD2C3318CA6C99D9C53E5B9FE17B7CF9661C5CDDDB97B90D5D3AF550100227EC8D6E6858FAE986AF2302C337B8DFEC6099898C19AA335A81317AB2B382DE72586AA9DF830C715332215AEBFD5E2FBA45F2BB5A7CA9793; path=/; HttpOnly
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<entry xml:base="http://sandboxapi.via.de/PublicApi/v1/Api.svc/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
<id>http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)</id>
<title type="text"></title>
<updated>2012-11-20T12:24:08Z</updated>
<author>
<name />
</author>
<link rel="edit" title="Product" href="Products(1L)" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ProductImages" type="application/atom+xml;type=feed" title="ProductImages" href="Products(1L)/ProductImages" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ChildProducts" type="application/atom+xml;type=feed" title="ChildProducts" href="Products(1L)/ChildProducts" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ParentProducts" type="application/atom+xml;type=feed" title="ParentProducts" href="Products(1L)/ParentProducts" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ProductSpecifics" type="application/atom+xml;type=feed" title="ProductSpecifics" href="Products(1L)/ProductSpecifics" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Catalogs" type="application/atom+xml;type=feed" title="Catalogs" href="Products(1L)/Catalogs" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ListingItems" type="application/atom+xml;type=feed" title="ListingItems" href="Products(1L)/ListingItems" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Listings" type="application/atom+xml;type=feed" title="Listings" href="Products(1L)/Listings" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ProductVariations" type="application/atom+xml;type=feed" title="ProductVariations" href="Products(1L)/ProductVariations" />
<category term="Via.BlackBox.Entities.Api.Product" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<content type="application/xml">
<m:properties>
<d:Id m:type="Edm.Int64">137</d:Id>
<d:ForeignId>SW10052</d:ForeignId>
<d:CreationDate m:type="Edm.DateTime">2012-11-05T14:18:17.507</d:CreationDate>
<d:Title>Adidas Adicolour Airliner Tasche Bag Original 2748 Airliner</d:Title>
<d:Description>Produktbeschreibung</d:Description>
<d:Price m:type="Edm.Decimal">99.9900</d:Price>
<d:StockAmount m:type="Edm.Int32">1</d:StockAmount>
<d:Ean>123-456-789</d:Ean>
<d:Upc m:null="true" />
<d:Isbn m:null="true" />
<d:ProductType m:type="Edm.Int16">0</d:ProductType>
<d:ModificationDate m:type="Edm.DateTime">2012-11-05T14:18:17.733</d:ModificationDate>
<d:MatchingStatus m:type="Edm.Byte">2</d:MatchingStatus>
</m:properties>
</content>
</entry>
Request HTTP-Header
Content-Type: application/atom+xml
Accept: application/json
SubscriptionToken: g93af799-6ae8-e111-8406-0050568261dc
Cookie: .ASPXAUTH=0186587E1743637D35632A7EDAF4F07EA67C6E4577770C3778FD9C17904A9D85B01369A8198B23A9AF530DBE93A68687C219BE1876B16B 0DAEBBD2C3318CA6C99D9C53E5B9FE17B7CF9661C5CDDDB97B90D5D3AF550100227EC8D6E6858FAE986AF2302C337B8DFEC6099898C19AA335A81317AB2B382DE72586AA9DF830C715332215AEBFD5E2FBA45F2BB5A7CA9793; path=/; HttpOnly
{
"d" : {
"__metadata" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)",
"type" : "Via.BlackBox.Entities.Api.Product"
},
"Id" : "1",
"ForeignId" : "SW10052",
"CreationDate" : "\/Date(1352125097507)\/",
"Title" : "Adidas Adicolour Airliner Tasche Bag Original 2748 Airliner",
"Description" : "Produktbeschreibung",
"Price" : "99.9900",
"StockAmount" : 1,
"Ean" : "123-456-789",
"Upc" : null,
"Isbn" : null,
"ProductType" : 0,
"ModificationDate" : "\/Date(1352125097733)\/",
"MatchingStatus" : 2,
"ProductImages" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)/ProductImages"
}
},
"ChildProducts" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)/ChildProducts"
}
},
"ParentProducts" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)/ParentProducts"
}
},
"ProductSpecifics" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)/ProductSpecifics"
}
},
"Catalogs" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)/Catalogs"
}
},
"ListingItems" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)/ListingItems"
}
},
"Listings" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)/Listings"
}
},
"ProductVariations" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/Products(1L)/ProductVariations"
}
}
}
}
Damit man eine Relation zu einem verkauften Artikel bzw. deren Variante und einem bestehenden Produkt im Fremdsystem herstellen kann, kann man die verknüpften Variantendaten zu dem verkauftem Artikel abrufen.
Request Methode
GET http://sandboxapi.via.de/publicapi/v1/api.svc/SalesOrderItems(1L)/ProductVariation
Request-HTTP-Header
Content-Type: application/atom+xml
SubscriptionToken: g93af799-6ae8-e111-8406-0050568261dc
Cookie: .ASPXAUTH=0186587E1743637D35632A7EDAF4F07EA67C6E4577770C3778FD9C17904A9D85B01369A8198B23A9AF530DBE93A68687C219BE1876B16B 0DAEBBD2C3318CA6C99D9C53E5B9FE17B7CF9661C5CDDDB97B90D5D3AF550100227EC8D6E6858FAE986AF2302C337B8DFEC6099898C19AA335A81317AB2B382DE72586AA9DF830C715332215AEBFD5E2FBA45F2BB5A7CA9793; path=/; HttpOnly
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<entry xml:base="http://sandboxapi.via.de/PublicApi/v1/Api.svc/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
<id>http://sandboxapi.via.de/PublicApi/v1/Api.svc/ProductVariations(1L)</id>
<title type="text"></title>
<updated>2012-11-23T14:40:20Z</updated>
<author>
<name />
</author>
<link rel="edit" title="ProductVariation" href="ProductVariations(1L)" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Product" type="application/atom+xml;type=entry" title="Product" href="ProductVariations(1L)/Product" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ProductVariationSpecifics" type="application/atom+xml;type=feed" title="ProductVariationSpecifics" href="ProductVariations(1L)/ProductVariationSpecifics" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/ListingItems" type="application/atom+xml;type=feed" title="ListingItems" href="ProductVariations(1L)/ListingItems" />
<link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/SalesOrderItems" type="application/atom+xml;type=feed" title="SalesOrderItems" href="ProductVariations(1L)/SalesOrderItems" />
<category term="Via.BlackBox.Entities.Api.ProductVariation" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
<content type="application/xml">
<m:properties>
<d:Id m:type="Edm.Int64">1</d:Id>
<d:ProductId m:type="Edm.Int64">1</d:ProductId>
<d:Price m:type="Edm.Decimal">17.9900</d:Price>
<d:StockAmount m:type="Edm.Int32">17</d:StockAmount>
<d:Sku>T-Shirt-Rot-S</d:Sku>
<d:ForeignId>ForeignId_des_Fremdsystems</d:ForeignId>
</m:properties>
</content>
</entry>
Request-HTTP-Header
Content-Type: application/json
Accept: application/json
SubscriptionToken: g93af799-6ae8-e111-8406-0050568261dc
Cookie: .ASPXAUTH=0186587E1743637D35632A7EDAF4F07EA67C6E4577770C3778FD9C17904A9D85B01369A8198B23A9AF530DBE93A68687C219BE1876B16B 0DAEBBD2C3318CA6C99D9C53E5B9FE17B7CF9661C5CDDDB97B90D5D3AF550100227EC8D6E6858FAE986AF2302C337B8DFEC6099898C19AA335A81317AB2B382DE72586AA9DF830C715332215AEBFD5E2FBA45F2BB5A7CA9793; path=/; HttpOnly
{
"d" : {
"__metadata" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/ProductVariations(1L)",
"type" : "Via.BlackBox.Entities.Api.ProductVariation"
},
"Id" : "1",
"ProductId" : "1",
"Price" : "17.9900",
"StockAmount" : 17,
"Sku" : "T-Shirt-Rot-S",
"ForeignId" : "ForeignId_des_Fremdsystems",
"Product" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/ProductVariations(1L)/Product"
}
},
"ProductVariationSpecifics" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/ProductVariations(1L)/ProductVariationSpecifics"
}
},
"ListingItems" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/ProductVariations(1L)/ListingItems"
}
},
"SalesOrderItems" : {
"__deferred" : {
"uri" : "http://sandboxapi.via.de/PublicApi/v1/Api.svc/ProductVariations(1L)/SalesOrderItems"
}
}
}
}