02. PurchaseRequisition

← トランザクション個別解説 目次へ戻る



02.01. PurchaseRequisitionRequest

 PurchaseRequisitionは、PunchOutOrderMessageとしてバイヤーがサプライヤから受け取った購入候補商品をバイヤー側内部で購入申請に向かわせる「購入権限者に購入を依頼する」プロセスです。一般的にバイヤー側には発注する権限のある人とない人がいて、発注を行う前には発注する権限のある人に承認を受ける必要があります。ですので、含まれる情報はPunchOutOrderMessageとしてバイヤーがサプライヤから受け取った情報とほぼ変わりません。その商品情報が承認前なのか承認後なのかの状態が変わります・

click here to expand/close XML view
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE cXML SYSTEM "https://electric-blue-industries.com/schemas/cXML/1.2.052/cXML.dtd">
<!--
 * Author:      Electric Blue Industries Ltd.
 * Author URI:  https://electric-blue-industries.com/
 * Copyright:   (c)2015-2023 Electric Blue Industries Ltd.
 * Contact:     admin@electric-blue-industris.com
 * License:     GNU General Public License v3.0
 * License URI: http://www.gnu.org/licenses/gpl-3.0.html
 * Reference:   http://xml.cxml.org/current/cXMLReferenceGuide.pdf
-->
<cXML timestamp="0000-00-00T00:00:00+09:00" payloadID="">
    <Header>
        <From>
            <Credential domain="DUNS">
                <Identity>123456789</Identity>
            </Credential>
        </From>
        <To>
            <Credential domain="NetworkID">
                <Identity>AN01000000001</Identity>
            </Credential>
        </To>
        <Sender>
            <Credential domain="DUNS">
                <Identity>123456789</Identity>
                <SharedSecret>SharedSecret</SharedSecret>
                <CredentialMac
                    type="FromSenderCredentials"
                    algorithm="HMAC-SHA1-96"
                    creationDate="0000-00-00T00:00:00+09:00"
                    expirationDate="0000-00-00T00:00:00+09:00">CredentialMAC</CredentialMac>
            </Credential>
            <UserAgent>Procurement Application Name</UserAgent>
        </Sender>
    </Header>
    <Request>
        <PurchaseRequisitionRequest>
            <PurchaseRequisition>
                <PurchaseRequisitionHeader requisitionID="" requisitionDate="" type="">
                    <Shipping/>
                    <Tax/>
                    <Total/>
                    <ShipTo>
                        <Address addressID="">
                        <Name xml:lang=""/>
                        <PostalAddress>
                            <DeliverTo/>
                            <Street/>
                            <City/>
                            <State isoStateCode=""/>
                            <PostalCode/>
                            <Country isoCountryCode=""/>
                        </PostalAddress>
                        </Address>
                    </ShipTo>
                    <BillTo>
                        <Address addressID="">
                        <Name xml:lang=""/>
                        <PostalAddress>
                        <Street/>
                        <City/>
                        <State isoStateCode=""/>
                        <PostalCode/>
                        <Country isoCountryCode=""/>
                        </PostalAddress>
                        </Address>
                    </BillTo>
                    <Contact role="">
                        <Name xml:lang=""/>
                        <PostalAddress>
                            <Street/>
                            <City/>
                            <State isoStateCode=""/>
                            <PostalCode/>
                            <Country isoCountryCode=""/>
                        </PostalAddress>
                        <Email/>
                    </Contact>
                    <!-- コメント要素は複数列挙することができる -->
                    <Comments xml:lang="" type="">comment described here</Comments>
                    <DocumentReference type="" />
                    <Extrinsic/>
                </PurchaseRequisitionHeader>
                <ItemIn quantity="" openQuantity="" promisedQuantity="" lineNumber="" parentLineNumber="" itemType="" compositeItemType="" itemClassification="" itemCategory="">
                <ItemID>
                    <SupplierPartID/>
                    <SupplierPartAuxiliaryID/>
                    <BuyerPartID/>
                    <IdReference/>
                </ItemID>
                <Path/>
                <ItemDetail>
                    <UnitPrice>
                        <Money currency=""/>
                    </UnitPrice>
                    <Description type="" xml:lang="">
                        <ShortName/>
                    </Description>
                    <OverallLimit>
                        <Money currency=""/>
                    </OverallLimit>
                    <ExpectedLimit>
                        <Money currency=""/>
                    </ExpectedLimit>
                    <UnitOfMeasure/>
                    <PriceBasisQuantity quantity="" conversionFactor="">
                        <UnitOfMeasure/>
                        <Description type="" xml:lang="">
                            <ShortName/>
                            description here
                        </Description>
                    </PriceBasisQuantity>
                    <Classification domain=""/>
                    <ManufacturerPartID/>
                    <ManufacturerName/>
                    <URL/>
                    <LeadTime/>
                    <!-- Dimensionは複数要素を列挙して複数の指定をすることが可能 -->
                    <!-- typeには length/width/height/weight/volume/stackHeight/grossWeight/grossVolume/unitGrossWeight/unitNetWeight を指定可能 -->
                    <Dimension quantity="" type="">
                        <UnitOfMeasure/>
                    </Dimension>
                    <ItemDetailIndustry isConfigurableMaterial="">
                        <ItemDetailRetail>
                            <EANID/>
                            <EuropeanWasteCatalogID/>
                            <Characteristic domain="" value="" code=""/>
                        </ItemDetailRetail>
                    </ItemDetailIndustry>
                    <AttachmentReference length="" version="">
                        <Name xml:lang=""/>
                        <Description xml:lang=""/>
                        <InternalID/>
                        <URL/>
                    </AttachmentReference>
                    <PlannedAcceptanceDays/>
                    <Extrinsic/>
                </ItemDetail>
                <SupplierList>
                    <!-- SupplierおよびSupplierIDは複数要素を列挙して複数を記載をすることが可能 -->
                    <Supplier>
                        <Name xml:lang=""/>
                        <SupplierID domain=""/>
                    </Supplier>
                </SupplierList>
                <ShipTo>
                    <Address addressID="" addressIDDomain="" isoCountryCode="">
                        <Name xml:lang=""/>
                        <PostalAddress name="">
                            <DeliverTo/>
                            <Street/>
                            <City/>
                            <State isoStateCode=""/>
                            <PostalCode/>
                            <Country isoCountryCode=""/>
                        </PostalAddress>
                    </Address>
                    <CarrierIdentifier domain=""/>
                    <TransportInformation>
                        <Route method=""/>
                        <ShippingContractNumber/>
                        <ShippingInstructions>
                            <Description xml:lang="">description here</Description>
                        </ShippingInstructions>
                    </TransportInformation>
                    <IdReference/>
                </ShipTo>
                <Shipping tracking="" trackingDomain="" trackingId="">
                    <Money alternateAmount="" alternateCurrency="" currency=""/>
                    <Description type="" xml:lang=""/>
                </Shipping>
                <!-- Taxが複数課される場合は TaxDetail を複数列挙することができる -->
                <Tax>
                    <Money currency=""/>
                    <Description xml:lang=""/>
                    <TaxDetail category="" percentageRate="" basePercentageRate="">
                        <TaxableAmount>
                            <Money currency=""/>
                        </TaxableAmount>
                        <TaxAmount>
                            <Money currency=""/>
                        </TaxAmount>
                        <TaxLocation xml:lang=""></TaxLocation>
                        <Description xml:lang=""></Description>
                    </TaxDetail>
                </Tax>
                <SpendDetail />
                <Distribution>
                    <Accounting name="">
                    <!-- AccountingSegmentは複数列挙することができる -->
                        <AccountingSegment id="">
                            <Name xml:lang=""/>
                            <Description xml:lang=""/>
                        </AccountingSegment>
                        <AccountingSegment id="">
                            <Name xml:lang=""/>
                            <Description xml:lang=""/>
                        </AccountingSegment>
                    </Accounting>
                    <Charge>
                        <Money currency=""/>
                    </Charge>
                </Distribution>
                <Contact role="">
                    <Name xml:lang=""/>
                    <PostalAddress>
                        <Street/>
                        <City/>
                        <State isoStateCode=""/>
                        <PostalCode/>
                        <Country isoCountryCode=""/>
                    </PostalAddress>
                    <Email/>
                </Contact>
                <!-- コメント要素は複数列挙することができる -->
                <Comments xml:lang="" type="">comment here</Comments>
                <ScheduleLine/>
                <BillTo/>
                <Batch/>
                <Period/>
                <DateInfo/>
                <Extrinsic/>
            </ItemIn>
            </PurchaseRequisition>
        </PurchaseRequisitionRequest>
    </Request>
</cXML>

下記が返送されるPurchaseRequisitionResponseの例です。他のAPIと同様にHeaderは存在しません。

<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE cXML SYSTEM "https://electric-blue-industries.com/schemas/cXML/1.2.052/cXML.dtd">
<cXML>
    <Response>
        <PurchaseRequisitionResponse effectiveDate="2023-07-01T05:24:29-08:00" lastRefresh="2023-07-08T05:24:29-08:00">
        </PurchaseRequisitionResponse>
    </Response>
</cXML>