PIDX PIP Specification. P22: Send Invoice Response. Version 1.0

Transcription

1 PIDX PIP Specification P22: Send Invoice Response Version 1.0 July 9, 2014

2 Table of Contents Document Version History Introduction Document Purpose Document Conventions Intended Audience References PIDX XML Transaction Standards, version RosettaNet Implementation Framework, version 2.0 (RNIF2) PIDX Dictionary Framework Other References Scope Send Invoice Response Partner Interface Process PIP Roles PIP Activities PIP P22 Business Rules and Constraints Data Requirements Optional Service Content Data Service Header Data Fundamental Business Data Entities inreplyto Business Signals Scope of Business Signals Base-level Validation Rules Process Control TRP requirements PIDX RNIF PIP Specification P22 Page 2 of 15 PIDX PIP P22 Invoice Response v1_0

3 6.1 Transport security Routing PIDX RNIF PIP Specification P22 Page 3 of 15 PIDX PIP P22 Invoice Response v1_0

4 Document Version History Date Version Author(s) Description 18 Mar Darren Ebanks, Rick Conner, Gary Strickland SLB internal Trading Partner Integration Process 20 Feb 2013 Draft John Stukes Updated PIP content 30 Jan Gary Strickland, Rick Conner, Larry Dyer Updated PIP content 20 Jun Gary Strickland Added PIP content 24 Jun Rick Conner, Larry Dyer, Darren Ebanks, Gary Strickland 1 Jul Rick Conner, Larry Dyer, Darren Ebanks, Gary Strickland 9 Jul Darren Ebanks, Paul O Shaughnessy, Gary Strickland Edited PIP for completeness, accuracy, and readability Added content Edited for completeness, accuracy, and readability PIDX RNIF PIP Specification P22 Page 4 of 15 PIDX PIP P22 Invoice Response v1_0

5 1 Introduction 1.1 Document Purpose Partner Interface Process (PIP) P22 Send Invoice Response is used with the PIP P21 Send Invoice to align a seller s invoicing process with a buyer s accounts payable process. This PIP specification provides information necessary to accomplish that alignment: Trading partner business roles Business activities executed by the roles The type and sequence of business documents exchanged by the role interactions while executing these activities The time, security, authentication, and performance constraints of these interactions The PIP specification focuses on the public business processes buyers and sellers use to create, transform, transmit, and process invoice response action messages. The specification does NOT identify the invoice response action message payload requirements; the buyer and seller MUST agree on payload requirements, and those requirements MUST be included in the seller s invoice response implementation guide. The trading partners executing the Send Invoice Response PIP must understand the processes in order to determine how trading partner data requirements can be addressed. 1.2 Document Conventions The Send Invoice Response PIP specification adopts the conventions expressed in the Internet Engineering Task Force s (IETF) Request for Comments (RFC) 2119 Key Words for Use in RFCs to Indicate Requirement Levels. The key words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL in this document are to be interpreted as described in RFC Intended Audience The targeted audience of the Send Invoice Response PIP specification includes trading partner technical and business personnel with the responsibility to align invoicing and accounts payable systems, as well as third party technology providers facilitating that alignment. 1.4 References The Send Invoice Response PIP specification relies on information in RosettaNet Implementation Framework, version 2.0 (RNIF2) and PIDX standards (Implementation Guide, Dictionary Framework, schemas, message guidelines). Users of the Send Invoice Response PIP specification MUST understand the content and purpose of the related documents. PIDX RNIF PIP Specification P22 Page 5 of 15 PIDX PIP P22 Invoice Response v1_0

6 1.4.1 PIDX XML Transaction Standards, version 2.0 PIDX XML Transaction standards consist of the standards master, the implementation guidelines, dictionaries, schemas, header message guidelines, and PIP specifications. Those documents should be considered integral parts of this PIP specification. The Send Invoice Response PIP specification does not restate material from referenced documents unless restatement adds clarity to the specification. There may be multiple versions of the invoice response schema. Trading partners implementing this PIP must agree on the version of invoice response schema that a buyer will use to send an invoice response to a seller. The invoice response schema used in the Send Invoice Response PIP MUST be identified in the seller s implementation guide RosettaNet Implementation Framework, version 2.0 (RNIF2) RNIF2 describes the transport, routing, and packaging (TRP) data and processing requirements. The PIDX XML Transaction Standards version 2.0 are based on RNIF2, but do not restate them. Accordingly, to understand how to execute the Send Invoice Response PIP, trading partners MUST have a solid understanding of RNIF2 and how the PIDX standards restrict that framework PIDX Dictionary Framework The PIDX standards use the XML Data Dictionary created in the PIDX XML Transaction Standards, version 1.0 to define service content XML elements: Data Dictionary V1-0.xls The elements in the message headers are defined in the following PIDX message guidelines: Preamble: PIDXPreambleMessageGuidelineV1_0.html Delivery Header: PIDXDeliveryHeaderMessageGuidelineV1_0.html Service Header: PIDXServiceHeaderMessageGuidelineV1_0.html Other References In addition to standards and specifications described above, trading partners implementing the Send Invoice Response PIP should be familiar with the following specifications and standards: XML 1.0 and W3C XML Schema The PIDX invoice response schema version agreed to by trading partners executing the Send Invoice Response PIP The PIDX library schema version agreed to by the trading partners executing the Send Invoice Response PIP General Internet protocols Encryption standards MIME and S/MIME Digital signatures and the Secure Socket Layer (SSL) PIDX RNIF PIP Specification P22 Page 6 of 15 PIDX PIP P22 Invoice Response v1_0

7 Buyer and seller process, data and TRP requirements and restrictions 1.5 Scope The Send Invoice Response PIP describes the processes and choreography to send an invoice response and acknowledge its receipt and processing status. To initiate an instance of the Send Invoice Response PIP, the buyer must have received and processed internally a PIDX invoice action message. The PIDX PIP P21: Send Invoice specification describes the roles, activities, and processes involved in sending an invoice action message to a buyer. Those processes are out of scope in the Send Invoice Response PIP. The Send Invoice Response PIP payload requirements are not described in this PIP specification. The invoice response payload requirements of the seller are described in the seller s invoice response implementation guide. 2 Send Invoice Response Partner Interface Process The Send Invoice Response Partner Interface Process (PIP) is used in aligning a seller s invoicing process with the buyer s payment approval process. There are two types of business processes involved in the PIP: private processes, and public processes. Private processes are business processes internal to each trading partner. Public processes are business processes that involve interactions with trading partners. The sequence diagram in figure 1 shows the relationship between public and some well-known private processes. While PIDX PIPs focus on public processes, private and public processes are interdependent. Accordingly, the Send Invoice Response PIP references private processes when those references provide clarity to the Send Invoice Response PIP. PIDX RNIF PIP Specification P22 Page 7 of 15 PIDX PIP P22 Invoice Response v1_0

8 Figure 1: Send Invoice Response PIP public and private processes The use case diagram in figure 2 shows the trading partner roles in the Send Invoice Response PIP, and the required activities (public processes) each role must execute. Figure 2: Send Invoice Response PIP trading partner roles and required activities PIDX RNIF PIP Specification P22 Page 8 of 15 PIDX PIP P22 Invoice Response v1_0

9 2.1 PIP Roles PIDX PIPs are based on a peer-to-peer message exchange model: Messages are exchanged between two trading partners: a buyer and a seller. The involvement of third parties to facilitate the exchange does not change the peer-to-peer message exchange model. Accordingly, the only roles described in the Send Invoice Response PIP are those of a buyer and a seller. 2.2 PIP Activities There are three required activities in the Send Invoice Response PIP: 1. The buyer sends an invoice response action message to the seller 2. The buyer and the seller validate syntax and structure of inbound messages (base-level validation) 3. The seller sends a business signal message to the buyer All other processes in the Send Invoice Response PIP are private processes. 3 PIP P22 Business Rules and Constraints Trading partners executing the Send Invoice Response PIP must agree on the business rules and process constraints for the PIP. The business rules that MUST be agreed to by the trading partners are listed in Table 1. The buyer and seller MAY add business rules and constraints not included in this list. Non-repudiation required Time to acknowledge Retry count limit for technical failures Business rule/constraint Authorization required to send invoice response Non-repudiation of origin and content Secure transport required Payload encryption required Validation limited to message syntax, structure (base-level validation) Payload will be validated against seller s business rules and data requirements before sending a business signal (content-level validation) Required value hh:mm:ss 0 count limit PIDX RNIF PIP Specification P22 Page 9 of 15 PIDX PIP P22 Invoice Response v1_0

10 URL to which the buyer must send the PIDX invoice response action message URL URL to which the seller must send the PIDX business signal message SSL required Server certificate required to for buyer to identify seller server Buyer certificate required to identify the buyer URL Table 1: Send Invoice Response business rules 4 Data Requirements Payload data requirements are specified in the seller s implementation guide. There may be multiple versions of the XML schemas controlling the structure and syntax of the Send Invoice Response PIP service content. The buyer and the seller MUST agree on which version of the PIDX library and the invoice response schema to use. The schemas agreed to by the buyer and seller MUST be published in the seller s Send Invoice Response Implementation Guidelines. The PIDX XML Transaction Standards define many optional information items in the PIDX schemas that control the structure, syntax, and required content of the invoice response service content. The buyer and seller MUST agree on which of the elements are required, and which are conditional. The seller MUST publish an implementation guide that includes the schemas and schema versions to be used, the service content required data, and any required attachments. 4.1 Optional Service Content Data Most of the data elements in PIDX XML schemas are optional. Required and conditional data elements MUST be agreed to by the buyer and seller, and described in the seller s implementation guide. When the seller s implementation guide does not define an optional XML information item as required or conditional, the information item is optional, and it MAY be included in the Send Invoice Response PIP service content. Optional information items included in the service content MUST NOT cause the invoice response to fail validation in the seller s system. 4.2 Service Header Data Fundamental Business Data Entities PIDX standards require each PIP specification to prescribe the values of certain business data elements. Table 2 contains a list of those elements, their definition, and, if possible the values that MUST be specified in each instance of this PIP. The values that must be used are in quotes. If a value cannot be specified in this section, the trading partners executing the PIP MUST agree on the value to use. PIDX RNIF PIP Specification P22 Page 10 of 15 PIDX PIP P22 Invoice Response v1_0

11 Other service header elements and their values are described in the PIDX General Implementation Guidelines, version 2.0. Element Name Definition Required Value BusinessActivityIdentifier An identifier which specifies a business activity Trading partners to agree PIDX requires the name of the XML schema to be used fromrole.globalpartnerroleclassificationcode Code identifying a party's role in the Buyer supply chain torole.globalpartnerroleclassificationcode Code identifying a party's role in the Seller supply chain fromservice.globalbusinessservicecode Code identifying a business service Buyer Service network component toservice.globalbusinessservicecode Code identifying a business service Seller Service network component GlobalBusinessActionCode Code identifying a business action Trading partners pipversion.versionidentifier Identifies the version of the PIP specification used to agree inreplyto A buyer sends an invoice response action message in response to a seller s originating invoice action message. The invoice response action message service header MUST uniquely identify the originating field ticket action message in the inreplyto element structure: inreplyto.actioncontrol.messagetrackingid.instanceidentifier The value of the messagetrackingid.instanceidentifier uniquely identifies the invoice action message for tracking purposes. The value of the InstanceIdentifier element is the value of the messagetrackingid.instanceidentifier element in the delivery header of the originating field ticket action message. 5 Business Signals The Send Invoice Response PIP requires the seller to send to the buyer a business signal containing the validation status of the invoice response action message. PIDX RNIF PIP Specification P22 Page 11 of 15 PIDX PIP P22 Invoice Response v1_0

12 5.1 Scope of Business Signals Business signals communicate the status of processing events of the invoice response action message in the seller s system. The seller s system MUST return a business signal reporting the base-level validation status of the following events: 1. The receipt and successful base-level validation of a message (Receipt Acknowledgment) 2. The receipt of an out-of-sequence message (Exception with a type of General Exception ) a. Example: If a buyer requires the seller to send a field ticket before sending an invoice, and the buyer receives the invoice before receiving the field ticket, the buyer MUST return a receipt acknowledgement exception with exception type of General Exception 3. The receipt of a message that has invalid grammar; it did not pass base-level validation (Exception with a type of Receipt Acknowledgment Exception ) Optionally, trading partners MAY agree to report content validation events in the business signal. Content validation includes validating that the invoice response action message s payload complies with the seller s business rules and data requirements. If the seller validates the invoice response payload before sending the receipt acknowledgment/exception to the buyer, then the buyer and seller MAY agree that the business signal returned includes both base-level validation and content-level validation. If the invoice response payload does not comply with the seller s business rules and service content data requirements, the seller MUST return an exception business signal. The Figure 3: Content-level validation activity diagram exception type is General Exception and the error code to use is PRF.DICT.VALERR. The activity diagram in figure 3 shows the process and message flow when the payload of an invoice response action message is validated before creating a receipt acknowledgment or exception signal. 5.2 Base-level Validation Rules The four XML parts of a PIDX message (preamble, delivery header, service header and service content) MUST be validated against a PIDX DTD and message guidelines (for the three header documents) or a PIDX invoice PIDX RNIF PIP Specification P22 Page 12 of 15 PIDX PIP P22 Invoice Response v1_0

13 response schema (for the service content). The following is the minimum level of validation required for each of the XML body parts. Validating for compliance with these rules is called base-level validation: 1. The XML document MUST be compliant with its corresponding DTD or schema 2. Where an element s data type and/or length is specified in the corresponding schema (in the case of the service content) or Message Guideline (in the case of the header parts), the element MUST be validated against the schema or Message Guideline 3. In validating header documents, where the cardinality specification of an element in the Message Guideline is different from the corresponding specification in the DTD, the specification in the Message Guideline is more accurate and MUST be adhered to 4. In validating header documents, where the sequence or naming of an element in the Message Guideline is different from the corresponding specification in the DTD, the specification in the DTD is more accurate and MUST be adhered to If a message does not comply with one or more of the above rules, then it MUST be deemed invalid, and the seller MUST return an exception business signal. 5.3 Process Control While executing a Send Invoice Response PIP, if an exception occurs in the seller s system after the seller returns a receipt acknowledgement business signal to the seller, the seller MUST return a Notification of Failure process control message. RosettaNet defines process control PIP 0A1 Notification of Failure to communicate process exceptions occurring outside of the context of the current process instance. For example, if the buyer and seller agree to base-level validation, the seller will return a business signal to the seller with base-level validation status. After the buyer receives the business signal from the seller, the Send Invoice Response process has completed in the buyer s system. However, the seller continues to process the payload of the buyer s invoice response action message to determine compliance with the seller s business rules and service content data requirements. If the seller s payload does not comply with the seller s business rules and data requirements, the process ends in an exception state in the seller s system. When this happens, the seller MUST notify the buyer of the exception event by sending a Notification of Failure. Figure 4 illustrates the process sequence and flow of messages in this example. PIDX RNIF PIP Specification P22 Page 13 of 15 PIDX PIP P22 Invoice Response v1_0

14 Figure 4: Out of bounds processing error sequence diagram 6 TRP requirements The PIDX transport, routing, and packaging (TRP) standard is based on the RosettaNet Implementation Framework 2.0 (RNIF2). RNIF2 utilizes existing standards including MIME multi-part/related, MIME multipart/signed, multipart/mixed, HTTP(S), SSL, PKCS#7, SMTP, and XML. Trading partners implementing the Send Invoice Response PIP MUST understand RNIF2, PIDX restrictions to RNIF2, and the standards used by RNIF2 including MIME, HTTP(S), and PKCS# Transport security Secure transport (SSL) is REQUIRED for the invoice response action message and the signal message exchanged between the buyer and seller. 6.2 Routing The buyer and the seller executing the Send Invoice Response PIP MUST use HTTP/S to send the action and signal messages. Accordingly, each trading partner must specify the URL to which the other trading partner must send messages: The seller must specify the URL to which the buyer sends the invoice response action message The buyer must specify the URL to which the seller sends the business signal One or both of the trading partners executing the Send Invoice Response PIP may direct the other trading partner to send messages to a third party technology service provider for processing. The trading partner that engages the third party technology service provider MUST provide the other trading partner with the service provider s URL. The engagement of a third party technology service provider by a trading partner does not change the PIDX peerto-peer message exchange model: Delivering a PIDX message to an intermediary at the direction of the intended PIDX RNIF PIP Specification P22 Page 14 of 15 PIDX PIP P22 Invoice Response v1_0

15 PIDX RNIF PIP Specification P22 Page 15 of 15 PIDX PIP P22 Invoice Response v1_0

16 ERROR: undefined OFFENDING COMMAND: ~ STACK: