AWS SDK for PHP 3.x (original) (raw)
Client: Aws\B2bi\B2biClient
Service ID: b2bi
Version: 2022-06-23
This page describes the parameters and results for the operations of the AWS B2B Data Interchange (2022-06-23), and shows how to use the Aws\B2bi\B2biClientobject to call the described operations. This documentation is specific to the 2022-06-23 API version of the service.
Operation Summary
Each of the following operations can be created from a client using$client->getCommand('CommandName')
, where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.
You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */)
. You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */)
.
CreateCapability ( array $params = [] )
Instantiates a capability based on the specified parameters.
CreatePartnership ( array $params = [] )
Creates a partnership between a customer and a trading partner, based on the supplied parameters.
CreateProfile ( array $params = [] )
Creates a customer profile.
CreateStarterMappingTemplate ( array $params = [] )
Amazon Web Services B2B Data Interchange uses a mapping template in JSONata or XSLT format to transform a customer input file into a JSON or XML file that can be converted to EDI.
CreateTransformer ( array $params = [] )
Creates a transformer.
DeleteCapability ( array $params = [] )
Deletes the specified capability.
DeletePartnership ( array $params = [] )
Deletes the specified partnership.
DeleteProfile ( array $params = [] )
Deletes the specified profile.
DeleteTransformer ( array $params = [] )
Deletes the specified transformer.
GenerateMapping ( array $params = [] )
Takes sample input and output documents and uses Amazon Bedrock to generate a mapping automatically.
GetCapability ( array $params = [] )
Retrieves the details for the specified capability.
GetPartnership ( array $params = [] )
Retrieves the details for a partnership, based on the partner and profile IDs specified.
GetProfile ( array $params = [] )
Retrieves the details for the profile specified by the profile ID.
GetTransformer ( array $params = [] )
Retrieves the details for the transformer specified by the transformer ID.
GetTransformerJob ( array $params = [] )
Returns the details of the transformer run, based on the Transformer job ID.
ListCapabilities ( array $params = [] )
Lists the capabilities associated with your Amazon Web Services account for your current or specified region.
ListPartnerships ( array $params = [] )
Lists the partnerships associated with your Amazon Web Services account for your current or specified region.
ListProfiles ( array $params = [] )
Lists the profiles associated with your Amazon Web Services account for your current or specified region.
ListTagsForResource ( array $params = [] )
Lists all of the tags associated with the Amazon Resource Name (ARN) that you specify.
ListTransformers ( array $params = [] )
Lists the available transformers.
StartTransformerJob ( array $params = [] )
Runs a job, using a transformer, to parse input EDI (electronic data interchange) file into the output structures used by Amazon Web Services B2B Data Interchange.
TagResource ( array $params = [] )
Attaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN).
TestConversion ( array $params = [] )
This operation mimics the latter half of a typical Outbound EDI request.
TestMapping ( array $params = [] )
Maps the input file according to the provided template file.
TestParsing ( array $params = [] )
Parses the input EDI (electronic data interchange) file.
UntagResource ( array $params = [] )
Detaches a key-value pair from the specified resource, as identified by its Amazon Resource Name (ARN).
UpdateCapability ( array $params = [] )
Updates some of the parameters for a capability, based on the specified parameters.
UpdatePartnership ( array $params = [] )
Updates some of the parameters for a partnership between a customer and trading partner.
UpdateProfile ( array $params = [] )
Updates the specified parameters for a profile.
UpdateTransformer ( array $params = [] )
Updates the specified parameters for a transformer.
Paginators
Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:
Operations
CreateCapability
result=result = result=client->createCapability
([/* ... /]); promise=promise = promise=client->createCapabilityAsync
([/ ... */]);
Instantiates a capability based on the specified parameters. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
Parameter Syntax
result=result = result=client->createCapability([ 'clientToken' => '', 'configuration' => [ // REQUIRED 'edi' => [ 'capabilityDirection' => 'INBOUND|OUTBOUND', 'inputLocation' => [ // REQUIRED 'bucketName' => '', 'key' => '', ], 'outputLocation' => [ // REQUIRED 'bucketName' => '', 'key' => '', ], 'transformerId' => '', // REQUIRED 'type' => [ // REQUIRED 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], ], ], 'instructionsDocuments' => [ [ 'bucketName' => '', 'key' => '', ], // ... ], 'name' => '', // REQUIRED 'tags' => [ [ 'Key' => '', // REQUIRED 'Value' => '', // REQUIRED ], // ... ], 'type' => 'edi', // REQUIRED ]);
Parameter Details
Members
clientToken
Reserved for future use.
configuration
Required: Yes
Type: CapabilityConfiguration structure
Specifies a structure that contains the details for a capability.
instructionsDocuments
Type: Array of S3Location structures
Specifies one or more locations in Amazon S3, each specifying an EDI document that can be used with this capability. Each item contains the name of the bucket and the key, to identify the document's location.
name
Required: Yes
Type: string
Specifies the name of the capability, used to identify it.
tags
Type: Array of Tag structures
Specifies the key-value pairs assigned to ARNs that you can use to group and search for resources by type. You can attach this metadata to resources (capabilities, partnerships, and so on) for any purpose.
type
Required: Yes
Type: string
Specifies the type of the capability. Currently, only edi
is supported.
Result Syntax
[ 'capabilityArn' => '', 'capabilityId' => '', 'configuration' => [ 'edi' => [ 'capabilityDirection' => 'INBOUND|OUTBOUND', 'inputLocation' => [ 'bucketName' => '', 'key' => '', ], 'outputLocation' => [ 'bucketName' => '', 'key' => '', ], 'transformerId' => '', 'type' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], ], ], 'createdAt' => , 'instructionsDocuments' => [ [ 'bucketName' => '', 'key' => '', ], // ... ], 'name' => '', 'type' => 'edi', ]
Result Details
Members
capabilityArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
capabilityId
Required: Yes
Type: string
Returns a system-assigned unique identifier for the capability.
configuration
Required: Yes
Type: CapabilityConfiguration structure
Returns a structure that contains the details for a capability.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the capability.
instructionsDocuments
Type: Array of S3Location structures
Returns one or more locations in Amazon S3, each specifying an EDI document that can be used with this capability. Each item contains the name of the bucket and the key, to identify the document's location.
name
Required: Yes
Type: string
Returns the name of the capability used to identify it.
type
Required: Yes
Type: string
Returns the type of the capability. Currently, only edi
is supported.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
ServiceQuotaExceededException:
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample CreateCapability call
result=result = result=client->createCapability([ 'name' => 'b2biexample', 'type' => 'edi', 'clientToken' => 'foo', 'configuration' => [ 'edi' => [ 'type' => [ 'x12Details' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'inputLocation' => [ 'key' => 'input/', 'bucketName' => 'test-bucket', ], 'outputLocation' => [ 'key' => 'output/', 'bucketName' => 'test-bucket', ], 'transformerId' => 'tr-9a893cf536df4658b', ], ], 'instructionsDocuments' => [ [ 'key' => 'instructiondoc.txt', 'bucketName' => 'test-bucket', ], ], 'tags' => [ [ 'Key' => 'capabilityKey1', 'Value' => 'capabilityValue1', ], ], ]);
Result syntax:
[ 'name' => 'b2biexample', 'type' => 'edi', 'capabilityArn' => 'arn:aws:b2bi:us-west-2:123456789012:capability/ca-963a8121e4fc4e348', 'capabilityId' => 'ca-963a8121e4fc4e348', 'configuration' => [ 'edi' => [ 'type' => [ 'x12Details' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'inputLocation' => [ 'key' => 'input/', 'bucketName' => 'test-bucket', ], 'outputLocation' => [ 'key' => 'output/', 'bucketName' => 'test-bucket', ], 'transformerId' => 'tr-9a893cf536df4658b', ], ], 'createdAt' => , 'instructionsDocuments' => [ [ 'key' => 'instructiondoc.txt', 'bucketName' => 'test-bucket', ], ], ]
CreatePartnership
result=result = result=client->createPartnership
([/* ... /]); promise=promise = promise=client->createPartnershipAsync
([/ ... */]);
Creates a partnership between a customer and a trading partner, based on the supplied parameters. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
Parameter Syntax
result=result = result=client->createPartnership([ 'capabilities' => ['', ...], // REQUIRED 'capabilityOptions' => [ 'outboundEdi' => [ 'x12' => [ 'common' => [ 'delimiters' => [ 'componentSeparator' => '', 'dataElementSeparator' => '', 'segmentTerminator' => '', ], 'functionalGroupHeaders' => [ 'applicationReceiverCode' => '', 'applicationSenderCode' => '', 'responsibleAgencyCode' => '', ], 'interchangeControlHeaders' => [ 'acknowledgmentRequestedCode' => '', 'receiverId' => '', 'receiverIdQualifier' => '', 'repetitionSeparator' => '', 'senderId' => '', 'senderIdQualifier' => '', 'usageIndicatorCode' => '', ], 'validateEdi' => true || false, ], ], ], ], 'clientToken' => '', 'email' => '', // REQUIRED 'name' => '', // REQUIRED 'phone' => '', 'profileId' => '', // REQUIRED 'tags' => [ [ 'Key' => '', // REQUIRED 'Value' => '', // REQUIRED ], // ... ], ]);
Parameter Details
Members
capabilities
Required: Yes
Type: Array of strings
Specifies a list of the capabilities associated with this partnership.
capabilityOptions
Type: CapabilityOptions structure
Specify the structure that contains the details for the associated capabilities.
clientToken
Reserved for future use.
Required: Yes
Type: string
Specifies the email address associated with this trading partner.
name
Required: Yes
Type: string
Specifies a descriptive name for the partnership.
phone
Specifies the phone number associated with the partnership.
profileId
Required: Yes
Type: string
Specifies the unique, system-generated identifier for the profile connected to this partnership.
tags
Type: Array of Tag structures
Specifies the key-value pairs assigned to ARNs that you can use to group and search for resources by type. You can attach this metadata to resources (capabilities, partnerships, and so on) for any purpose.
Result Syntax
[ 'capabilities' => ['', ...], 'capabilityOptions' => [ 'outboundEdi' => [ 'x12' => [ 'common' => [ 'delimiters' => [ 'componentSeparator' => '', 'dataElementSeparator' => '', 'segmentTerminator' => '', ], 'functionalGroupHeaders' => [ 'applicationReceiverCode' => '', 'applicationSenderCode' => '', 'responsibleAgencyCode' => '', ], 'interchangeControlHeaders' => [ 'acknowledgmentRequestedCode' => '', 'receiverId' => '', 'receiverIdQualifier' => '', 'repetitionSeparator' => '', 'senderId' => '', 'senderIdQualifier' => '', 'usageIndicatorCode' => '', ], 'validateEdi' => true || false, ], ], ], ], 'createdAt' => , 'email' => '', 'name' => '', 'partnershipArn' => '', 'partnershipId' => '', 'phone' => '', 'profileId' => '', 'tradingPartnerId' => '', ]
Result Details
Members
capabilities
Returns one or more capabilities associated with this partnership.
capabilityOptions
Type: CapabilityOptions structure
Returns the structure that contains the details for the associated capabilities.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the partnership.
Returns the email address associated with this trading partner.
name
Returns a descriptive name for the partnership.
partnershipArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
partnershipId
Required: Yes
Type: string
Returns the unique, system-generated identifier for a partnership.
phone
Returns the phone number associated with the partnership.
profileId
Required: Yes
Type: string
Returns the unique, system-generated identifier for the profile connected to this partnership.
tradingPartnerId
Returns the unique, system-generated identifier for a trading partner.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
ServiceQuotaExceededException:
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample CreatePartnership call
result=result = result=client->createPartnership([ 'name' => 'b2bipartner', 'capabilities' => [ 'ca-963a8121e4fc4e348', ], 'clientToken' => 'foo', 'email' => 'john@example.com', 'phone' => '5555555555', 'profileId' => 'p-60fbc37c87f04fce9', 'tags' => [ [ 'Key' => 'sampleKey1', 'Value' => 'sampleValue1', ], ], ]);
Result syntax:
[ 'name' => 'b2bipartner', 'capabilities' => [ 'ca-963a8121e4fc4e348', ], 'createdAt' => , 'email' => 'john@example.com', 'partnershipArn' => 'arn:aws:b2bi:us-west-2:123456789012:partnership/ps-60fbc37c87f04fce9', 'partnershipId' => 'ps-219fa02f5b4242af8', 'phone' => '5555555555', 'profileId' => 'p-60fbc37c87f04fce9', 'tradingPartnerId' => 'tp-2a17ca447f6f4a8a8', ]
CreateProfile
result=result = result=client->createProfile
([/* ... /]); promise=promise = promise=client->createProfileAsync
([/ ... */]);
Creates a customer profile. You can have up to five customer profiles, each representing a distinct private network. A profile is the mechanism used to create the concept of a private network.
Parameter Syntax
result=result = result=client->createProfile([ 'businessName' => '', // REQUIRED 'clientToken' => '', 'email' => '', 'logging' => 'ENABLED|DISABLED', // REQUIRED 'name' => '', // REQUIRED 'phone' => '', // REQUIRED 'tags' => [ [ 'Key' => '', // REQUIRED 'Value' => '', // REQUIRED ], // ... ], ]);
Parameter Details
Members
businessName
Required: Yes
Type: string
Specifies the name for the business associated with this profile.
clientToken
Reserved for future use.
Specifies the email address associated with this customer profile.
logging
Required: Yes
Type: string
Specifies whether or not logging is enabled for this profile.
name
Required: Yes
Type: string
Specifies the name of the profile.
phone
Required: Yes
Type: string
Specifies the phone number associated with the profile.
tags
Type: Array of Tag structures
Specifies the key-value pairs assigned to ARNs that you can use to group and search for resources by type. You can attach this metadata to resources (capabilities, partnerships, and so on) for any purpose.
Result Syntax
[ 'businessName' => '', 'createdAt' => , 'email' => '', 'logGroupName' => '', 'logging' => 'ENABLED|DISABLED', 'name' => '', 'phone' => '', 'profileArn' => '', 'profileId' => '', ]
Result Details
Members
businessName
Required: Yes
Type: string
Returns the name for the business associated with this profile.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp representing the time the profile was created.
Returns the email address associated with this customer profile.
logGroupName
Returns the name of the logging group.
logging
Returns whether or not logging is turned on for this profile.
name
Required: Yes
Type: string
Returns the name of the profile, used to identify it.
phone
Required: Yes
Type: string
Returns the phone number associated with the profile.
profileArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for the profile.
profileId
Required: Yes
Type: string
Returns the unique, system-generated identifier for the profile.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
ServiceQuotaExceededException:
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample CreateProfile call
result=result = result=client->createProfile([ 'name' => 'Shipping Profile', 'businessName' => 'John's Shipping', 'clientToken' => 'foo', 'email' => 'john@example.com', 'logging' => 'ENABLED', 'phone' => '5555555555', 'tags' => [ [ 'Key' => 'sampleKey', 'Value' => 'sampleValue', ], ], ]);
Result syntax:
[ 'name' => 'Shipping Profile', 'businessName' => 'John's Trucking', 'createdAt' => , 'email' => 'john@example.com', 'logGroupName' => 'b2bi/p-60fbc37c87f04fce9-Logs', 'logging' => 'ENABLED', 'phone' => '5555555555', 'profileArn' => 'arn:aws:b2bi:us-west-2:123456789012:profile/p-60fbc37c87f04fce9', 'profileId' => 'p-60fbc37c87f04fce9', ]
CreateStarterMappingTemplate
result=result = result=client->createStarterMappingTemplate
([/* ... /]); promise=promise = promise=client->createStarterMappingTemplateAsync
([/ ... */]);
Amazon Web Services B2B Data Interchange uses a mapping template in JSONata or XSLT format to transform a customer input file into a JSON or XML file that can be converted to EDI.
If you provide a sample EDI file with the same structure as the EDI files that you wish to generate, then the service can generate a mapping template. The starter template contains placeholder values which you can replace with JSONata or XSLT expressions to take data from your input file and insert it into the JSON or XML file that is used to generate the EDI.
If you do not provide a sample EDI file, then the service can generate a mapping template based on the EDI settings in the templateDetails
parameter.
Currently, we only support generating a template that can generate the input to produce an Outbound X12 EDI file.
Parameter Syntax
result=result = result=client->createStarterMappingTemplate([ 'mappingType' => 'JSONATA|XSLT', // REQUIRED 'outputSampleLocation' => [ 'bucketName' => '', 'key' => '', ], 'templateDetails' => [ // REQUIRED 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], ]);
Parameter Details
Members
mappingType
Required: Yes
Type: string
Specify the format for the mapping template: either JSONATA or XSLT.
outputSampleLocation
Type: S3Location structure
Specify the location of the sample EDI file that is used to generate the mapping template.
templateDetails
Required: Yes
Type: TemplateDetails structure
Describes the details needed for generating the template. Specify the X12 transaction set and version for which the template is used: currently, we only support X12.
Result Syntax
[ 'mappingTemplate' => '', ]
Result Details
Members
mappingTemplate
Required: Yes
Type: string
Returns a string that represents the mapping template.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample CreateStarterMappingTemplate call
result=result = result=client->createStarterMappingTemplate([ 'mappingType' => 'JSONATA', 'outputSampleLocation' => [ 'key' => 'output-sample-key', 'bucketName' => 'output-sample-bucket', ], 'templateDetails' => [ 'x12' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], ]);
Result syntax:
[ 'mappingTemplate' => 'Example Mapping Template', ]
CreateTransformer
result=result = result=client->createTransformer
([/* ... /]); promise=promise = promise=client->createTransformerAsync
([/ ... */]);
Creates a transformer. Amazon Web Services B2B Data Interchange currently supports two scenarios:
- Inbound EDI: the Amazon Web Services customer receives an EDI file from their trading partner. Amazon Web Services B2B Data Interchange converts this EDI file into a JSON or XML file with a service-defined structure. A mapping template provided by the customer, in JSONata or XSLT format, is optionally applied to this file to produce a JSON or XML file with the structure the customer requires.
- Outbound EDI: the Amazon Web Services customer has a JSON or XML file containing data that they wish to use in an EDI file. A mapping template, provided by the customer (in either JSONata or XSLT format) is applied to this file to generate a JSON or XML file in the service-defined structure. This file is then converted to an EDI file.
The following fields are provided for backwards compatibility only: fileFormat
, mappingTemplate
, ediType
, and sampleDocument
.
- Use the
mapping
data type in place ofmappingTemplate
andfileFormat
- Use the
sampleDocuments
data type in place ofsampleDocument
- Use either the
inputConversion
oroutputConversion
in place ofediType
Parameter Syntax
result=result = result=client->createTransformer([ 'clientToken' => '', 'ediType' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fileFormat' => 'XML|JSON|NOT_USED', 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fromFormat' => 'X12', // REQUIRED ], 'mapping' => [ 'template' => '', 'templateLanguage' => 'XSLT|JSONATA', // REQUIRED ], 'mappingTemplate' => '', 'name' => '', // REQUIRED 'outputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'toFormat' => 'X12', // REQUIRED ], 'sampleDocument' => '', 'sampleDocuments' => [ 'bucketName' => '', // REQUIRED 'keys' => [ // REQUIRED [ 'input' => '', 'output' => '', ], // ... ], ], 'tags' => [ [ 'Key' => '', // REQUIRED 'Value' => '', // REQUIRED ], // ... ], ]);
Parameter Details
Members
clientToken
Reserved for future use.
ediType
Specifies the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
fileFormat
Specifies that the currently supported file formats for EDI transformations are JSON
and XML
.
inputConversion
Type: InputConversion structure
Specify the InputConversion
object, which contains the format options for the inbound transformation.
mapping
Specify the structure that contains the mapping template and its language (either XSLT or JSONATA).
mappingTemplate
Specifies the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
This parameter is available for backwards compatibility. Use the Mapping data type instead.
name
Required: Yes
Type: string
Specifies the name of the transformer, used to identify it.
outputConversion
Type: OutputConversion structure
A structure that contains the OutputConversion
object, which contains the format options for the outbound transformation.
sampleDocument
Specifies a sample EDI document that is used by a transformer as a guide for processing the EDI data.
sampleDocuments
Type: SampleDocuments structure
Specify a structure that contains the Amazon S3 bucket and an array of the corresponding keys used to identify the location for your sample documents.
tags
Type: Array of Tag structures
Specifies the key-value pairs assigned to ARNs that you can use to group and search for resources by type. You can attach this metadata to resources (capabilities, partnerships, and so on) for any purpose.
Result Syntax
[ 'createdAt' => , 'ediType' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fileFormat' => 'XML|JSON|NOT_USED', 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '', 'templateLanguage' => 'XSLT|JSONATA', ], 'mappingTemplate' => '', 'name' => '', 'outputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'toFormat' => 'X12', ], 'sampleDocument' => '', 'sampleDocuments' => [ 'bucketName' => '', 'keys' => [ [ 'input' => '', 'output' => '', ], // ... ], ], 'status' => 'active|inactive', 'transformerArn' => '', 'transformerId' => '', ]
Result Details
Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the transformer.
ediType
Returns the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
fileFormat
Returns that the currently supported file formats for EDI transformations are JSON
and XML
.
inputConversion
Type: InputConversion structure
Returns the InputConversion
object, which contains the format options for the inbound transformation.
mapping
Returns the structure that contains the mapping template and its language (either XSLT or JSONATA).
mappingTemplate
Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
name
Required: Yes
Type: string
Returns the name of the transformer, used to identify it.
outputConversion
Type: OutputConversion structure
Returns the OutputConversion
object, which contains the format options for the outbound transformation.
sampleDocument
Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.
sampleDocuments
Type: SampleDocuments structure
Returns a structure that contains the Amazon S3 bucket and an array of the corresponding keys used to identify the location for your sample documents.
status
Required: Yes
Type: string
Returns the state of the newly created transformer. The transformer can be either active
or inactive
. For the transformer to be used in a capability, its status must active
.
transformerArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
transformerId
Required: Yes
Type: string
Returns the system-assigned unique identifier for the transformer.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
ServiceQuotaExceededException:
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample CreateTransformer call
result=result = result=client->createTransformer([ 'name' => 'transformX12', 'clientToken' => 'foo', 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '{}', 'templateLanguage' => 'JSONATA', ], 'sampleDocuments' => [ 'bucketName' => 'test-bucket', 'keys' => [ [ 'input' => 'sampleDoc.txt', ], ], ], 'tags' => [ [ 'Key' => 'sampleKey', 'Value' => 'sampleValue', ], ], ]);
Result syntax:
[ 'name' => 'transformX12', 'createdAt' => , 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '{}', 'templateLanguage' => 'JSONATA', ], 'sampleDocuments' => [ 'bucketName' => 'test-bucket', 'keys' => [ [ 'input' => 'sampleDoc.txt', ], ], ], 'status' => 'inactive', 'transformerArn' => 'arn:aws:b2bi:us-west-2:123456789012:transformer/tr-974c129999f84d8c9', 'transformerId' => 'tr-974c129999f84d8c9', ]
DeleteCapability
result=result = result=client->deleteCapability
([/* ... /]); promise=promise = promise=client->deleteCapabilityAsync
([/ ... */]);
Deletes the specified capability. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
Parameter Syntax
result=result = result=client->deleteCapability([ 'capabilityId' => '', // REQUIRED ]);
Parameter Details
Members
capabilityId
Required: Yes
Type: string
Specifies a system-assigned unique identifier for the capability.
Result Syntax
[]
Result Details
The results for this operation are always empty.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample DeleteCapabilty call
result=result = result=client->deleteCapability([ 'capabilityId' => 'ca-963a8121e4fc4e348', ]);
DeletePartnership
result=result = result=client->deletePartnership
([/* ... /]); promise=promise = promise=client->deletePartnershipAsync
([/ ... */]);
Deletes the specified partnership. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
Parameter Syntax
result=result = result=client->deletePartnership([ 'partnershipId' => '', // REQUIRED ]);
Parameter Details
Members
partnershipId
Required: Yes
Type: string
Specifies the unique, system-generated identifier for a partnership.
Result Syntax
[]
Result Details
The results for this operation are always empty.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample DeletePartnership call
result=result = result=client->deletePartnership([ 'partnershipId' => 'ps-219fa02f5b4242af8', ]);
DeleteProfile
result=result = result=client->deleteProfile
([/* ... /]); promise=promise = promise=client->deleteProfileAsync
([/ ... */]);
Deletes the specified profile. A profile is the mechanism used to create the concept of a private network.
Parameter Syntax
result=result = result=client->deleteProfile([ 'profileId' => '', // REQUIRED ]);
Parameter Details
Members
profileId
Required: Yes
Type: string
Specifies the unique, system-generated identifier for the profile.
Result Syntax
[]
Result Details
The results for this operation are always empty.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample DeleteProfile call
result=result = result=client->deleteProfile([ 'profileId' => 'p-60fbc37c87f04fce9', ]);
DeleteTransformer
result=result = result=client->deleteTransformer
([/* ... /]); promise=promise = promise=client->deleteTransformerAsync
([/ ... */]);
Deletes the specified transformer. A transformer can take an EDI file as input and transform it into a JSON-or XML-formatted document. Alternatively, a transformer can take a JSON-or XML-formatted document as input and transform it into an EDI file.
Parameter Syntax
result=result = result=client->deleteTransformer([ 'transformerId' => '', // REQUIRED ]);
Parameter Details
Members
transformerId
Required: Yes
Type: string
Specifies the system-assigned unique identifier for the transformer.
Result Syntax
[]
Result Details
The results for this operation are always empty.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample DeleteTransformer call
result=result = result=client->deleteTransformer([ 'transformerId' => 'tr-974c129999f84d8c9', ]);
GenerateMapping
result=result = result=client->generateMapping
([/* ... /]); promise=promise = promise=client->generateMappingAsync
([/ ... */]);
Takes sample input and output documents and uses Amazon Bedrock to generate a mapping automatically. Depending on the accuracy and other factors, you can then edit the mapping for your needs.
Before you can use the AI-assisted feature for Amazon Web Services B2B Data Interchange you must enable models in Amazon Bedrock. For details, see AI-assisted template mapping prerequisites in the Amazon Web Services B2B Data Interchange User guide.
Parameter Syntax
result=result = result=client->generateMapping([ 'inputFileContent' => '', // REQUIRED 'mappingType' => 'JSONATA|XSLT', // REQUIRED 'outputFileContent' => '', // REQUIRED ]);
Parameter Details
Members
inputFileContent
Required: Yes
Type: string
Provide the contents of a sample X12 EDI file (for inbound EDI) or JSON/XML file (for outbound EDI) to use as a starting point for the mapping.
mappingType
Required: Yes
Type: string
Specify the mapping type: either JSONATA
or XSLT.
outputFileContent
Required: Yes
Type: string
Provide the contents of a sample X12 EDI file (for outbound EDI) or JSON/XML file (for inbound EDI) to use as a target for the mapping.
Result Syntax
[ 'mappingAccuracy' => , 'mappingTemplate' => '', ]
Result Details
Members
mappingAccuracy
Returns a percentage that estimates the accuracy of the generated mapping.
mappingTemplate
Required: Yes
Type: string
Returns a mapping template based on your inputs.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample GenerateMapping call
result=result = result=client->generateMapping([ 'inputFileContent' => 'Sample input file content', 'mappingType' => 'JSONATA', 'outputFileContent' => 'Sample output file content', ]);
Result syntax:
[ 'mappingAccuracy' => 0.95, 'mappingTemplate' => 'Sample mapping content', ]
GetCapability
result=result = result=client->getCapability
([/* ... /]); promise=promise = promise=client->getCapabilityAsync
([/ ... */]);
Retrieves the details for the specified capability. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
Parameter Syntax
result=result = result=client->getCapability([ 'capabilityId' => '', // REQUIRED ]);
Parameter Details
Members
capabilityId
Required: Yes
Type: string
Specifies a system-assigned unique identifier for the capability.
Result Syntax
[ 'capabilityArn' => '', 'capabilityId' => '', 'configuration' => [ 'edi' => [ 'capabilityDirection' => 'INBOUND|OUTBOUND', 'inputLocation' => [ 'bucketName' => '', 'key' => '', ], 'outputLocation' => [ 'bucketName' => '', 'key' => '', ], 'transformerId' => '', 'type' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], ], ], 'createdAt' => , 'instructionsDocuments' => [ [ 'bucketName' => '', 'key' => '', ], // ... ], 'modifiedAt' => , 'name' => '', 'type' => 'edi', ]
Result Details
Members
capabilityArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
capabilityId
Required: Yes
Type: string
Returns a system-assigned unique identifier for the capability.
configuration
Required: Yes
Type: CapabilityConfiguration structure
Returns a structure that contains the details for a capability.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the capability.
instructionsDocuments
Type: Array of S3Location structures
Returns one or more locations in Amazon S3, each specifying an EDI document that can be used with this capability. Each item contains the name of the bucket and the key, to identify the document's location.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for last time the capability was modified.
name
Required: Yes
Type: string
Returns the name of the capability, used to identify it.
type
Required: Yes
Type: string
Returns the type of the capability. Currently, only edi
is supported.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample GetCapabilty call
result=result = result=client->getCapability([ 'capabilityId' => 'ca-963a8121e4fc4e348', ]);
Result syntax:
[ 'name' => 'b2biexample', 'type' => 'edi', 'capabilityArn' => 'arn:aws:b2bi:us-west-2:123456789012:capability/ca-963a8121e4fc4e348', 'capabilityId' => 'ca-963a8121e4fc4e348', 'configuration' => [ 'edi' => [ 'type' => [ 'x12Details' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'inputLocation' => [ 'key' => 'input/', 'bucketName' => 'test-bucket', ], 'outputLocation' => [ 'key' => 'output/', 'bucketName' => 'test-bucket', ], 'transformerId' => 'tr-9a893cf536df4658b', ], ], 'createdAt' => , 'instructionsDocuments' => [ [ 'key' => 'instructiondoc.txt', 'bucketName' => 'test-bucket', ], ], 'modifiedAt' => , ]
GetPartnership
result=result = result=client->getPartnership
([/* ... /]); promise=promise = promise=client->getPartnershipAsync
([/ ... */]);
Retrieves the details for a partnership, based on the partner and profile IDs specified. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
Parameter Syntax
result=result = result=client->getPartnership([ 'partnershipId' => '', // REQUIRED ]);
Parameter Details
Members
partnershipId
Required: Yes
Type: string
Specifies the unique, system-generated identifier for a partnership.
Result Syntax
[ 'capabilities' => ['', ...], 'capabilityOptions' => [ 'outboundEdi' => [ 'x12' => [ 'common' => [ 'delimiters' => [ 'componentSeparator' => '', 'dataElementSeparator' => '', 'segmentTerminator' => '', ], 'functionalGroupHeaders' => [ 'applicationReceiverCode' => '', 'applicationSenderCode' => '', 'responsibleAgencyCode' => '', ], 'interchangeControlHeaders' => [ 'acknowledgmentRequestedCode' => '', 'receiverId' => '', 'receiverIdQualifier' => '', 'repetitionSeparator' => '', 'senderId' => '', 'senderIdQualifier' => '', 'usageIndicatorCode' => '', ], 'validateEdi' => true || false, ], ], ], ], 'createdAt' => , 'email' => '', 'modifiedAt' => , 'name' => '', 'partnershipArn' => '', 'partnershipId' => '', 'phone' => '', 'profileId' => '', 'tradingPartnerId' => '', ]
Result Details
Members
capabilities
Returns one or more capabilities associated with this partnership.
capabilityOptions
Type: CapabilityOptions structure
Contains the details for an Outbound EDI capability.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the partnership.
Returns the email address associated with this trading partner.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp that identifies the most recent date and time that the partnership was modified.
name
Returns the display name of the partnership
partnershipArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
partnershipId
Required: Yes
Type: string
Returns the unique, system-generated identifier for a partnership.
phone
Returns the phone number associated with the partnership.
profileId
Required: Yes
Type: string
Returns the unique, system-generated identifier for the profile connected to this partnership.
tradingPartnerId
Returns the unique identifier for the partner for this partnership.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample GetPartnership call
result=result = result=client->getPartnership([ 'partnershipId' => 'ps-219fa02f5b4242af8', ]);
Result syntax:
[ 'name' => 'b2bipartner', 'capabilities' => [ 'ca-963a8121e4fc4e348', ], 'createdAt' => , 'email' => 'john@example.com', 'modifiedAt' => , 'partnershipArn' => 'arn:aws:b2bi:us-west-2:123456789012:partnership/ps-219fa02f5b4242af8', 'partnershipId' => 'ps-219fa02f5b4242af8', 'phone' => '5555555555', 'profileId' => 'p-60fbc37c87f04fce9', 'tradingPartnerId' => 'tp-2a17ca447f6f4a8a8', ]
GetProfile
result=result = result=client->getProfile
([/* ... /]); promise=promise = promise=client->getProfileAsync
([/ ... */]);
Retrieves the details for the profile specified by the profile ID. A profile is the mechanism used to create the concept of a private network.
Parameter Syntax
result=result = result=client->getProfile([ 'profileId' => '', // REQUIRED ]);
Parameter Details
Members
profileId
Required: Yes
Type: string
Specifies the unique, system-generated identifier for the profile.
Result Syntax
[ 'businessName' => '', 'createdAt' => , 'email' => '', 'logGroupName' => '', 'logging' => 'ENABLED|DISABLED', 'modifiedAt' => , 'name' => '', 'phone' => '', 'profileArn' => '', 'profileId' => '', ]
Result Details
Members
businessName
Required: Yes
Type: string
Returns the name for the business associated with this profile.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the transformer.
Returns the email address associated with this customer profile.
logGroupName
Returns the name of the logging group.
logging
Returns whether or not logging is enabled for this profile.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for last time the profile was modified.
name
Required: Yes
Type: string
Returns the name of the profile, used to identify it.
phone
Required: Yes
Type: string
Returns the phone number associated with the profile.
profileArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
profileId
Required: Yes
Type: string
Returns the unique, system-generated identifier for the profile.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample GetProfile call
result=result = result=client->getProfile([ 'profileId' => 'p-60fbc37c87f04fce9', ]);
Result syntax:
[ 'name' => 'Shipping Profile', 'businessName' => 'John's Trucking', 'createdAt' => , 'email' => 'john@example.com', 'logGroupName' => 'b2bi/p-60fbc37c87f04fce9-Logs', 'logging' => 'ENABLED', 'phone' => '5555555555', 'profileArn' => 'arn:aws:b2bi:us-west-2:123456789012:profile/p-60fbc37c87f04fce9', 'profileId' => 'p-60fbc37c87f04fce9', ]
GetTransformer
result=result = result=client->getTransformer
([/* ... /]); promise=promise = promise=client->getTransformerAsync
([/ ... */]);
Retrieves the details for the transformer specified by the transformer ID. A transformer can take an EDI file as input and transform it into a JSON-or XML-formatted document. Alternatively, a transformer can take a JSON-or XML-formatted document as input and transform it into an EDI file.
Parameter Syntax
result=result = result=client->getTransformer([ 'transformerId' => '', // REQUIRED ]);
Parameter Details
Members
transformerId
Required: Yes
Type: string
Specifies the system-assigned unique identifier for the transformer.
Result Syntax
[ 'createdAt' => , 'ediType' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fileFormat' => 'XML|JSON|NOT_USED', 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '', 'templateLanguage' => 'XSLT|JSONATA', ], 'mappingTemplate' => '', 'modifiedAt' => , 'name' => '', 'outputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'toFormat' => 'X12', ], 'sampleDocument' => '', 'sampleDocuments' => [ 'bucketName' => '', 'keys' => [ [ 'input' => '', 'output' => '', ], // ... ], ], 'status' => 'active|inactive', 'transformerArn' => '', 'transformerId' => '', ]
Result Details
Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the transformer.
ediType
Returns the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
fileFormat
Returns that the currently supported file formats for EDI transformations are JSON
and XML
.
inputConversion
Type: InputConversion structure
Returns the InputConversion
object, which contains the format options for the inbound transformation.
mapping
Returns the structure that contains the mapping template and its language (either XSLT or JSONATA).
mappingTemplate
Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for last time the transformer was modified.
name
Required: Yes
Type: string
Returns the name of the transformer, used to identify it.
outputConversion
Type: OutputConversion structure
Returns the OutputConversion
object, which contains the format options for the outbound transformation.
sampleDocument
Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.
sampleDocuments
Type: SampleDocuments structure
Returns a structure that contains the Amazon S3 bucket and an array of the corresponding keys used to identify the location for your sample documents.
status
Required: Yes
Type: string
Returns the state of the newly created transformer. The transformer can be either active
or inactive
. For the transformer to be used in a capability, its status must active
.
transformerArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
transformerId
Required: Yes
Type: string
Returns the system-assigned unique identifier for the transformer.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample GetTransformer call
result=result = result=client->getTransformer([ 'transformerId' => 'tr-974c129999f84d8c9', ]);
Result syntax:
[ 'name' => 'transformX12', 'createdAt' => , 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '{}', 'templateLanguage' => 'JSONATA', ], 'sampleDocuments' => [ 'bucketName' => 'test-bucket', 'keys' => [ [ 'input' => 'sampleDoc.txt', ], ], ], 'status' => 'inactive', 'transformerArn' => 'arn:aws:b2bi:us-west-2:123456789012:transformer/tr-974c129999f84d8c9', 'transformerId' => 'tr-974c129999f84d8c9', ]
GetTransformerJob
result=result = result=client->getTransformerJob
([/* ... /]); promise=promise = promise=client->getTransformerJobAsync
([/ ... */]);
Returns the details of the transformer run, based on the Transformer job ID.
Parameter Syntax
result=result = result=client->getTransformerJob([ 'transformerId' => '', // REQUIRED 'transformerJobId' => '', // REQUIRED ]);
Parameter Details
Members
transformerId
Required: Yes
Type: string
Specifies the system-assigned unique identifier for the transformer.
transformerJobId
Required: Yes
Type: string
Specifies the unique, system-generated identifier for a transformer run.
Result Syntax
[ 'message' => '', 'outputFiles' => [ [ 'bucketName' => '', 'key' => '', ], // ... ], 'status' => 'running|succeeded|failed', ]
Result Details
Members
message
Returns an optional error message, which gets populated when the job is not run successfully.
outputFiles
Type: Array of S3Location structures
Returns the location for the output files. If the caller specified a directory for the output, then this contains the full path to the output file, including the file name generated by the service.
status
Required: Yes
Type: string
Returns the current state of the transformer job, either running
, succeeded
, or failed
.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample GetTransformerJob call
result=result = result=client->getTransformerJob([ 'transformerId' => 'tr-974c129999f84d8c9', 'transformerJobId' => 'tj-vpYxfV7yQOqjMSYllEslLw', ]);
Result syntax:
[ 'message' => 'Transformed, writing output', 'outputFiles' => [ [ 'key' => 'output/sample-214.edi.2023-11-01T10:44:03.353Z.json', 'bucketName' => 'gt-edi-test', ], ], 'status' => 'succeeded', ]
ListCapabilities
result=result = result=client->listCapabilities
([/* ... /]); promise=promise = promise=client->listCapabilitiesAsync
([/ ... */]);
Lists the capabilities associated with your Amazon Web Services account for your current or specified region. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
Parameter Syntax
result=result = result=client->listCapabilities([ 'maxResults' => , 'nextToken' => '', ]);
Parameter Details
Members
maxResults
Specifies the maximum number of capabilities to return.
nextToken
When additional results are obtained from the command, a NextToken
parameter is returned in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing additional resources.
Result Syntax
[ 'capabilities' => [ [ 'capabilityId' => '', 'createdAt' => , 'modifiedAt' => , 'name' => '', 'type' => 'edi', ], // ... ], 'nextToken' => '', ]
Result Details
Members
capabilities
Required: Yes
Type: Array of CapabilitySummary structures
Returns one or more capabilities associated with this partnership.
nextToken
When additional results are obtained from the command, a NextToken
parameter is returned in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing additional resources.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample ListCapabilities call
result=result = result=client->listCapabilities([ 'maxResults' => 50, 'nextToken' => 'foo', ]);
Result syntax:
[ 'capabilities' => [ [ 'name' => 'b2biexample', 'type' => 'edi', 'capabilityId' => 'ca-963a8121e4fc4e348', 'createdAt' => , 'modifiedAt' => , ], ], 'nextToken' => 'foo', ]
ListPartnerships
result=result = result=client->listPartnerships
([/* ... /]); promise=promise = promise=client->listPartnershipsAsync
([/ ... */]);
Lists the partnerships associated with your Amazon Web Services account for your current or specified region. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
Parameter Syntax
result=result = result=client->listPartnerships([ 'maxResults' => , 'nextToken' => '', 'profileId' => '', ]);
Parameter Details
Members
maxResults
Specifies the maximum number of capabilities to return.
nextToken
When additional results are obtained from the command, a NextToken
parameter is returned in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing additional resources.
profileId
Specifies the unique, system-generated identifier for the profile connected to this partnership.
Result Syntax
[ 'nextToken' => '', 'partnerships' => [ [ 'capabilities' => ['', ...], 'capabilityOptions' => [ 'outboundEdi' => [ 'x12' => [ 'common' => [ 'delimiters' => [ 'componentSeparator' => '', 'dataElementSeparator' => '', 'segmentTerminator' => '', ], 'functionalGroupHeaders' => [ 'applicationReceiverCode' => '', 'applicationSenderCode' => '', 'responsibleAgencyCode' => '', ], 'interchangeControlHeaders' => [ 'acknowledgmentRequestedCode' => '', 'receiverId' => '', 'receiverIdQualifier' => '', 'repetitionSeparator' => '', 'senderId' => '', 'senderIdQualifier' => '', 'usageIndicatorCode' => '', ], 'validateEdi' => true || false, ], ], ], ], 'createdAt' => , 'modifiedAt' => , 'name' => '', 'partnershipId' => '', 'profileId' => '', 'tradingPartnerId' => '', ], // ... ], ]
Result Details
Members
nextToken
When additional results are obtained from the command, a NextToken
parameter is returned in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing additional resources.
partnerships
Required: Yes
Type: Array of PartnershipSummary structures
Specifies a list of your partnerships.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample ListPartnerships call
result=result = result=client->listPartnerships([ 'maxResults' => 50, 'nextToken' => 'foo', 'profileId' => 'p-60fbc37c87f04fce9', ]);
Result syntax:
[ 'nextToken' => 'string', 'partnerships' => [ [ 'name' => 'b2bipartner', 'capabilities' => [ 'ca-963a8121e4fc4e348', ], 'createdAt' => , 'modifiedAt' => , 'partnershipId' => 'ps-219fa02f5b4242af8', 'profileId' => 'p-60fbc37c87f04fce9', 'tradingPartnerId' => 'tp-2a17ca447f6f4a8a8', ], ], ]
ListProfiles
result=result = result=client->listProfiles
([/* ... /]); promise=promise = promise=client->listProfilesAsync
([/ ... */]);
Lists the profiles associated with your Amazon Web Services account for your current or specified region. A profile is the mechanism used to create the concept of a private network.
Parameter Syntax
result=result = result=client->listProfiles([ 'maxResults' => , 'nextToken' => '', ]);
Parameter Details
Members
maxResults
Specifies the maximum number of profiles to return.
nextToken
When additional results are obtained from the command, a NextToken
parameter is returned in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing additional resources.
Result Syntax
[ 'nextToken' => '', 'profiles' => [ [ 'businessName' => '', 'createdAt' => , 'logGroupName' => '', 'logging' => 'ENABLED|DISABLED', 'modifiedAt' => , 'name' => '', 'profileId' => '', ], // ... ], ]
Result Details
Members
nextToken
When additional results are obtained from the command, a NextToken
parameter is returned in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing additional resources.
profiles
Required: Yes
Type: Array of ProfileSummary structures
Returns an array of ProfileSummary
objects.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample ListProfiles call
result=result = result=client->listProfiles([ 'maxResults' => 50, 'nextToken' => 'foo', ]);
Result syntax:
[ 'nextToken' => 'foo', 'profiles' => [ [ 'name' => 'Shipping Profile', 'businessName' => 'John's Trucking', 'createdAt' => , 'logGroupName' => 'b2bi/p-60fbc37c87f04fce9-Logs', 'logging' => 'ENABLED', 'profileId' => 'p-60fbc37c87f04fce9', ], ], ]
ListTagsForResource
result=result = result=client->listTagsForResource
([/* ... /]); promise=promise = promise=client->listTagsForResourceAsync
([/ ... */]);
Lists all of the tags associated with the Amazon Resource Name (ARN) that you specify. The resource can be a capability, partnership, profile, or transformer.
Parameter Syntax
result=result = result=client->listTagsForResource([ 'ResourceARN' => '', // REQUIRED ]);
Parameter Details
Members
ResourceARN
Required: Yes
Type: string
Requests the tags associated with a particular Amazon Resource Name (ARN). An ARN is an identifier for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
Result Syntax
[ 'Tags' => [ [ 'Key' => '', 'Value' => '', ], // ... ], ]
Result Details
Members
Tags
Type: Array of Tag structures
Returns the key-value pairs assigned to ARNs that you can use to group and search for resources by type. You can attach this metadata to resources (capabilities, partnerships, and so on) for any purpose.
Errors
Occurs when a B2BI object cannot be validated against a request from another object.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample ListTagsForResources call
result=result = result=client->listTagsForResource([ 'ResourceARN' => 'arn:aws:b2bi:us-west-2:123456789012:profile/p-60fbc37c87f04fce9', ]);
Result syntax:
[ 'Tags' => [ [ 'Key' => 'sampleKey', 'Value' => 'SampleValue', ], ], ]
ListTransformers
result=result = result=client->listTransformers
([/* ... /]); promise=promise = promise=client->listTransformersAsync
([/ ... */]);
Lists the available transformers. A transformer can take an EDI file as input and transform it into a JSON-or XML-formatted document. Alternatively, a transformer can take a JSON-or XML-formatted document as input and transform it into an EDI file.
Parameter Syntax
result=result = result=client->listTransformers([ 'maxResults' => , 'nextToken' => '', ]);
Parameter Details
Members
maxResults
Specifies the number of items to return for the API response.
nextToken
When additional results are obtained from the command, a NextToken
parameter is returned in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing additional resources.
Result Syntax
[ 'nextToken' => '', 'transformers' => [ [ 'createdAt' => , 'ediType' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fileFormat' => 'XML|JSON|NOT_USED', 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '', 'templateLanguage' => 'XSLT|JSONATA', ], 'mappingTemplate' => '', 'modifiedAt' => , 'name' => '', 'outputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'toFormat' => 'X12', ], 'sampleDocument' => '', 'sampleDocuments' => [ 'bucketName' => '', 'keys' => [ [ 'input' => '', 'output' => '', ], // ... ], ], 'status' => 'active|inactive', 'transformerId' => '', ], // ... ], ]
Result Details
Members
nextToken
When additional results are obtained from the command, a NextToken
parameter is returned in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing additional resources.
transformers
Required: Yes
Type: Array of TransformerSummary structures
Returns an array of one or more transformer objects.
For each transformer, a TransformerSummary
object is returned. The TransformerSummary
contains all the details for a specific transformer.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample ListTransformers call
result=result = result=client->listTransformers([ 'maxResults' => 50, 'nextToken' => 'foo', ]);
Result syntax:
[ 'nextToken' => 'foo', 'transformers' => [ [ 'name' => 'transformJSON', 'createdAt' => , 'ediType' => [ 'x12Details' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'fileFormat' => 'JSON', 'mappingTemplate' => '$', 'modifiedAt' => , 'sampleDocument' => 's3://test-bucket/sampleDoc.txt', 'status' => 'inactive', 'transformerId' => 'tr-974c129999f84d8c9', ], ], ]
StartTransformerJob
result=result = result=client->startTransformerJob
([/* ... /]); promise=promise = promise=client->startTransformerJobAsync
([/ ... */]);
Runs a job, using a transformer, to parse input EDI (electronic data interchange) file into the output structures used by Amazon Web Services B2B Data Interchange.
If you only want to transform EDI (electronic data interchange) documents, you don't need to create profiles, partnerships or capabilities. Just create and configure a transformer, and then run the StartTransformerJob
API to process your files.
Parameter Syntax
result=result = result=client->startTransformerJob([ 'clientToken' => '', 'inputFile' => [ // REQUIRED 'bucketName' => '', 'key' => '', ], 'outputLocation' => [ // REQUIRED 'bucketName' => '', 'key' => '', ], 'transformerId' => '', // REQUIRED ]);
Parameter Details
Members
clientToken
Reserved for future use.
inputFile
Required: Yes
Type: S3Location structure
Specifies the location of the input file for the transformation. The location consists of an Amazon S3 bucket and prefix.
outputLocation
Required: Yes
Type: S3Location structure
Specifies the location of the output file for the transformation. The location consists of an Amazon S3 bucket and prefix.
transformerId
Required: Yes
Type: string
Specifies the system-assigned unique identifier for the transformer.
Result Syntax
[ 'transformerJobId' => '', ]
Result Details
Members
transformerJobId
Required: Yes
Type: string
Returns the unique, system-generated identifier for a transformer run.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample StartTransformerJob call
result=result = result=client->startTransformerJob([ 'clientToken' => 'foo', 'inputFile' => [ 'key' => 'input/inputFile.txt', 'bucketName' => 'test-bucket', ], 'outputLocation' => [ 'key' => 'output/', 'bucketName' => 'test-bucket', ], 'transformerId' => 'tr-974c129999f84d8c9', ]);
Result syntax:
[ 'transformerJobId' => 'tj-vpYxfV7yQOqjMSYllEslLw', ]
TagResource
result=result = result=client->tagResource
([/* ... /]); promise=promise = promise=client->tagResourceAsync
([/ ... */]);
Attaches a key-value pair to a resource, as identified by its Amazon Resource Name (ARN). Resources are capability, partnership, profile, transformers and other entities.
There is no response returned from this call.
Parameter Syntax
result=result = result=client->tagResource([ 'ResourceARN' => '', // REQUIRED 'Tags' => [ // REQUIRED [ 'Key' => '', // REQUIRED 'Value' => '', // REQUIRED ], // ... ], ]);
Parameter Details
Members
ResourceARN
Required: Yes
Type: string
Specifies an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
Tags
Required: Yes
Type: Array of Tag structures
Specifies the key-value pairs assigned to ARNs that you can use to group and search for resources by type. You can attach this metadata to resources (capabilities, partnerships, and so on) for any purpose.
Result Syntax
[]
Result Details
The results for this operation are always empty.
Errors
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample TagResource call
result=result = result=client->tagResource([ 'ResourceARN' => 'arn:aws:b2bi:us-west-2:123456789012:profile/p-60fbc37c87f04fce9', 'Tags' => [ [ 'Key' => 'sampleKey', 'Value' => 'SampleValue', ], ], ]);
TestConversion
result=result = result=client->testConversion
([/* ... /]); promise=promise = promise=client->testConversionAsync
([/ ... */]);
This operation mimics the latter half of a typical Outbound EDI request. It takes an input JSON/XML in the B2Bi shape as input, converts it to an X12 EDI string, and return that string.
Parameter Syntax
result=result = result=client->testConversion([ 'source' => [ // REQUIRED 'fileFormat' => 'JSON|XML', // REQUIRED 'inputFile' => [ // REQUIRED 'fileContent' => '', ], ], 'target' => [ // REQUIRED 'fileFormat' => 'X12', // REQUIRED 'formatDetails' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'outputSampleFile' => [ 'fileLocation' => [ 'bucketName' => '', 'key' => '', ], ], ], ]);
Parameter Details
Members
source
Required: Yes
Type: ConversionSource structure
Specify the source file for an outbound EDI request.
target
Required: Yes
Type: ConversionTarget structure
Specify the format (X12 is the only currently supported format), and other details for the conversion target.
Result Syntax
[ 'convertedFileContent' => '', 'validationMessages' => ['', ...], ]
Result Details
Members
convertedFileContent
Required: Yes
Type: string
Returns the converted file content.
validationMessages
Returns an array of strings, each containing a message that Amazon Web Services B2B Data Interchange generates during the conversion.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample TestConversion call
result=result = result=client->testConversion([ 'source' => [ 'fileFormat' => 'JSON', 'inputFile' => [ 'fileContent' => 'Sample file content', ], ], 'target' => [ 'fileFormat' => 'X12', 'formatDetails' => [ 'x12' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], ], ]);
Result syntax:
[ 'convertedFileContent' => 'Sample converted file content', 'validationMessages' => [ ], ]
TestMapping
result=result = result=client->testMapping
([/* ... /]); promise=promise = promise=client->testMappingAsync
([/ ... */]);
Maps the input file according to the provided template file. The API call downloads the file contents from the Amazon S3 location, and passes the contents in as a string, to the inputFileContent
parameter.
Parameter Syntax
result=result = result=client->testMapping([ 'fileFormat' => 'XML|JSON|NOT_USED', // REQUIRED 'inputFileContent' => '', // REQUIRED 'mappingTemplate' => '', // REQUIRED ]);
Parameter Details
Members
fileFormat
Required: Yes
Type: string
Specifies that the currently supported file formats for EDI transformations are JSON
and XML
.
inputFileContent
Required: Yes
Type: string
Specify the contents of the EDI (electronic data interchange) XML or JSON file that is used as input for the transform.
mappingTemplate
Required: Yes
Type: string
Specifies the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
This parameter is available for backwards compatibility. Use the Mapping data type instead.
Result Syntax
[ 'mappedFileContent' => '', ]
Result Details
Members
mappedFileContent
Required: Yes
Type: string
Returns a string for the mapping that can be used to identify the mapping. Similar to a fingerprint
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample TestMapping call
result=result = result=client->testMapping([ 'fileFormat' => 'JSON', 'inputFileContent' => 'Sample file content', 'mappingTemplate' => '$', ]);
Result syntax:
[ 'mappedFileContent' => 'Sample file content', ]
TestParsing
result=result = result=client->testParsing
([/* ... /]); promise=promise = promise=client->testParsingAsync
([/ ... */]);
Parses the input EDI (electronic data interchange) file. The input file has a file size limit of 250 KB.
Parameter Syntax
result=result = result=client->testParsing([ 'ediType' => [ // REQUIRED 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fileFormat' => 'XML|JSON|NOT_USED', // REQUIRED 'inputFile' => [ // REQUIRED 'bucketName' => '', 'key' => '', ], ]);
Parameter Details
Members
ediType
Required: Yes
Type: EdiType structure
Specifies the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
fileFormat
Required: Yes
Type: string
Specifies that the currently supported file formats for EDI transformations are JSON
and XML
.
inputFile
Required: Yes
Type: S3Location structure
Specifies an S3Location
object, which contains the Amazon S3 bucket and prefix for the location of the input file.
Result Syntax
[ 'parsedFileContent' => '', ]
Result Details
Members
parsedFileContent
Required: Yes
Type: string
Returns the contents of the input file being tested, parsed according to the specified EDI (electronic data interchange) type.
Errors
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample TestParsing call
result=result = result=client->testParsing([ 'ediType' => [ 'x12Details' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'fileFormat' => 'JSON', 'inputFile' => [ 'key' => 'sampleFile.txt', 'bucketName' => 'test-bucket', ], ]);
Result syntax:
[ 'parsedFileContent' => 'Sample parsed file content', ]
UntagResource
result=result = result=client->untagResource
([/* ... /]); promise=promise = promise=client->untagResourceAsync
([/ ... */]);
Detaches a key-value pair from the specified resource, as identified by its Amazon Resource Name (ARN). Resources are capability, partnership, profile, transformers and other entities.
Parameter Syntax
result=result = result=client->untagResource([ 'ResourceARN' => '', // REQUIRED 'TagKeys' => ['', ...], // REQUIRED ]);
Parameter Details
Members
ResourceARN
Required: Yes
Type: string
Specifies an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
TagKeys
Required: Yes
Type: Array of strings
Specifies the key-value pairs assigned to ARNs that you can use to group and search for resources by type. You can attach this metadata to resources (capabilities, partnerships, and so on) for any purpose.
Result Syntax
[]
Result Details
The results for this operation are always empty.
Errors
Occurs when a B2BI object cannot be validated against a request from another object.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample UntagResource call
result=result = result=client->untagResource([ 'ResourceARN' => 'arn:aws:b2bi:us-west-2:123456789012:profile/p-60fbc37c87f04fce9', 'TagKeys' => [ 'sampleKey', ], ]);
UpdateCapability
result=result = result=client->updateCapability
([/* ... /]); promise=promise = promise=client->updateCapabilityAsync
([/ ... */]);
Updates some of the parameters for a capability, based on the specified parameters. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
Parameter Syntax
result=result = result=client->updateCapability([ 'capabilityId' => '', // REQUIRED 'configuration' => [ 'edi' => [ 'capabilityDirection' => 'INBOUND|OUTBOUND', 'inputLocation' => [ // REQUIRED 'bucketName' => '', 'key' => '', ], 'outputLocation' => [ // REQUIRED 'bucketName' => '', 'key' => '', ], 'transformerId' => '', // REQUIRED 'type' => [ // REQUIRED 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], ], ], 'instructionsDocuments' => [ [ 'bucketName' => '', 'key' => '', ], // ... ], 'name' => '', ]);
Parameter Details
Members
capabilityId
Required: Yes
Type: string
Specifies a system-assigned unique identifier for the capability.
configuration
Type: CapabilityConfiguration structure
Specifies a structure that contains the details for a capability.
instructionsDocuments
Type: Array of S3Location structures
Specifies one or more locations in Amazon S3, each specifying an EDI document that can be used with this capability. Each item contains the name of the bucket and the key, to identify the document's location.
name
Specifies a new name for the capability, to replace the existing name.
Result Syntax
[ 'capabilityArn' => '', 'capabilityId' => '', 'configuration' => [ 'edi' => [ 'capabilityDirection' => 'INBOUND|OUTBOUND', 'inputLocation' => [ 'bucketName' => '', 'key' => '', ], 'outputLocation' => [ 'bucketName' => '', 'key' => '', ], 'transformerId' => '', 'type' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], ], ], 'createdAt' => , 'instructionsDocuments' => [ [ 'bucketName' => '', 'key' => '', ], // ... ], 'modifiedAt' => , 'name' => '', 'type' => 'edi', ]
Result Details
Members
capabilityArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
capabilityId
Required: Yes
Type: string
Returns a system-assigned unique identifier for the capability.
configuration
Required: Yes
Type: CapabilityConfiguration structure
Returns a structure that contains the details for a capability.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the capability.
instructionsDocuments
Type: Array of S3Location structures
Returns one or more locations in Amazon S3, each specifying an EDI document that can be used with this capability. Each item contains the name of the bucket and the key, to identify the document's location.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for last time the capability was modified.
name
Required: Yes
Type: string
Returns the name of the capability, used to identify it.
type
Required: Yes
Type: string
Returns the type of the capability. Currently, only edi
is supported.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
ServiceQuotaExceededException:
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample UpdateCapability call
result=result = result=client->updateCapability([ 'name' => 'b2biexample', 'capabilityId' => 'ca-963a8121e4fc4e348', 'configuration' => [ 'edi' => [ 'type' => [ 'x12Details' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'inputLocation' => [ 'key' => 'input/', 'bucketName' => 'test-bucket', ], 'outputLocation' => [ 'key' => 'output/', 'bucketName' => 'test-bucket', ], 'transformerId' => 'tr-9a893cf536df4658b', ], ], 'instructionsDocuments' => [ [ 'key' => 'instructiondoc.txt', 'bucketName' => 'test-bucket', ], ], ]);
Result syntax:
[ 'name' => 'b2biexample', 'type' => 'edi', 'capabilityArn' => 'arn:aws:b2bi:us-west-2:123456789012:capability/ca-963a8121e4fc4e348', 'capabilityId' => 'ca-963a8121e4fc4e348', 'configuration' => [ 'edi' => [ 'type' => [ 'x12Details' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'inputLocation' => [ 'key' => 'input/', 'bucketName' => 'test-bucket', ], 'outputLocation' => [ 'key' => 'output/', 'bucketName' => 'test-bucket', ], 'transformerId' => 'tr-9a893cf536df4658b', ], ], 'createdAt' => , 'instructionsDocuments' => [ [ 'key' => 'instructiondoc.txt', 'bucketName' => 'test-bucket', ], ], 'modifiedAt' => , ]
UpdatePartnership
result=result = result=client->updatePartnership
([/* ... /]); promise=promise = promise=client->updatePartnershipAsync
([/ ... */]);
Updates some of the parameters for a partnership between a customer and trading partner. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
Parameter Syntax
result=result = result=client->updatePartnership([ 'capabilities' => ['', ...], 'capabilityOptions' => [ 'outboundEdi' => [ 'x12' => [ 'common' => [ 'delimiters' => [ 'componentSeparator' => '', 'dataElementSeparator' => '', 'segmentTerminator' => '', ], 'functionalGroupHeaders' => [ 'applicationReceiverCode' => '', 'applicationSenderCode' => '', 'responsibleAgencyCode' => '', ], 'interchangeControlHeaders' => [ 'acknowledgmentRequestedCode' => '', 'receiverId' => '', 'receiverIdQualifier' => '', 'repetitionSeparator' => '', 'senderId' => '', 'senderIdQualifier' => '', 'usageIndicatorCode' => '', ], 'validateEdi' => true || false, ], ], ], ], 'name' => '', 'partnershipId' => '', // REQUIRED ]);
Parameter Details
Members
capabilities
List of the capabilities associated with this partnership.
capabilityOptions
Type: CapabilityOptions structure
To update, specify the structure that contains the details for the associated capabilities.
name
The name of the partnership, used to identify it.
partnershipId
Required: Yes
Type: string
Specifies the unique, system-generated identifier for a partnership.
Result Syntax
[ 'capabilities' => ['', ...], 'capabilityOptions' => [ 'outboundEdi' => [ 'x12' => [ 'common' => [ 'delimiters' => [ 'componentSeparator' => '', 'dataElementSeparator' => '', 'segmentTerminator' => '', ], 'functionalGroupHeaders' => [ 'applicationReceiverCode' => '', 'applicationSenderCode' => '', 'responsibleAgencyCode' => '', ], 'interchangeControlHeaders' => [ 'acknowledgmentRequestedCode' => '', 'receiverId' => '', 'receiverIdQualifier' => '', 'repetitionSeparator' => '', 'senderId' => '', 'senderIdQualifier' => '', 'usageIndicatorCode' => '', ], 'validateEdi' => true || false, ], ], ], ], 'createdAt' => , 'email' => '', 'modifiedAt' => , 'name' => '', 'partnershipArn' => '', 'partnershipId' => '', 'phone' => '', 'profileId' => '', 'tradingPartnerId' => '', ]
Result Details
Members
capabilities
Returns one or more capabilities associated with this partnership.
capabilityOptions
Type: CapabilityOptions structure
Returns the structure that contains the details for the associated capabilities.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp that identifies the most recent date and time that the partnership was modified.
Returns the email address associated with this trading partner.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp that identifies the most recent date and time that the partnership was modified.
name
The name of the partnership, used to identify it.
partnershipArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
partnershipId
Required: Yes
Type: string
Returns the unique, system-generated identifier for a partnership.
phone
Returns the phone number associated with the partnership.
profileId
Required: Yes
Type: string
Returns the unique, system-generated identifier for the profile connected to this partnership.
tradingPartnerId
Returns the unique, system-generated identifier for a trading partner.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
ServiceQuotaExceededException:
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample UpdatePartnership call
result=result = result=client->updatePartnership([ 'name' => 'b2bipartner', 'capabilities' => [ 'ca-963a8121e4fc4e348', ], 'partnershipId' => 'ps-219fa02f5b4242af8', ]);
Result syntax:
[ 'name' => 'b2bipartner', 'capabilities' => [ 'ca-963a8121e4fc4e348', ], 'createdAt' => , 'email' => 'john@example.com', 'modifiedAt' => , 'partnershipArn' => 'arn:aws:b2bi:us-west-2:123456789012:partnership/ps-60fbc37c87f04fce9', 'partnershipId' => 'ps-219fa02f5b4242af8', 'phone' => '5555555555', 'profileId' => 'p-60fbc37c87f04fce9', 'tradingPartnerId' => 'tp-2a17ca447f6f4a8a8', ]
UpdateProfile
result=result = result=client->updateProfile
([/* ... /]); promise=promise = promise=client->updateProfileAsync
([/ ... */]);
Updates the specified parameters for a profile. A profile is the mechanism used to create the concept of a private network.
Parameter Syntax
result=result = result=client->updateProfile([ 'businessName' => '', 'email' => '', 'name' => '', 'phone' => '', 'profileId' => '', // REQUIRED ]);
Parameter Details
Members
businessName
Specifies the name for the business associated with this profile.
Specifies the email address associated with this customer profile.
name
The name of the profile, used to identify it.
phone
Specifies the phone number associated with the profile.
profileId
Required: Yes
Type: string
Specifies the unique, system-generated identifier for the profile.
Result Syntax
[ 'businessName' => '', 'createdAt' => , 'email' => '', 'logGroupName' => '', 'logging' => 'ENABLED|DISABLED', 'modifiedAt' => , 'name' => '', 'phone' => '', 'profileArn' => '', 'profileId' => '', ]
Result Details
Members
businessName
Required: Yes
Type: string
Returns the name for the business associated with this profile.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the profile.
Returns the email address associated with this customer profile.
logGroupName
Returns the name of the logging group.
logging
Specifies whether or not logging is enabled for this profile.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for last time the profile was modified.
name
Required: Yes
Type: string
Returns the name of the profile.
phone
Required: Yes
Type: string
Returns the phone number associated with the profile.
profileArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for the profile.
profileId
Required: Yes
Type: string
Returns the unique, system-generated identifier for the profile.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
ServiceQuotaExceededException:
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample UpdateProfile call
result=result = result=client->updateProfile([ 'name' => 'Shipping Profile', 'businessName' => 'John's Shipping', 'email' => 'john@example.com', 'phone' => '5555555555', 'profileId' => 'p-60fbc37c87f04fce9', ]);
Result syntax:
[ 'name' => 'Shipping Profile', 'businessName' => 'John's Trucking', 'createdAt' => , 'email' => 'john@example.com', 'logGroupName' => 'b2bi/p-60fbc37c87f04fce9-Logs', 'logging' => 'ENABLED', 'modifiedAt' => , 'phone' => '5555555555', 'profileArn' => 'arn:aws:b2bi:us-west-2:123456789012:profile/p-60fbc37c87f04fce9', 'profileId' => 'p-60fbc37c87f04fce9', ]
UpdateTransformer
result=result = result=client->updateTransformer
([/* ... /]); promise=promise = promise=client->updateTransformerAsync
([/ ... */]);
Updates the specified parameters for a transformer. A transformer can take an EDI file as input and transform it into a JSON-or XML-formatted document. Alternatively, a transformer can take a JSON-or XML-formatted document as input and transform it into an EDI file.
Parameter Syntax
result=result = result=client->updateTransformer([ 'ediType' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fileFormat' => 'XML|JSON|NOT_USED', 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fromFormat' => 'X12', // REQUIRED ], 'mapping' => [ 'template' => '', 'templateLanguage' => 'XSLT|JSONATA', // REQUIRED ], 'mappingTemplate' => '', 'name' => '', 'outputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'toFormat' => 'X12', // REQUIRED ], 'sampleDocument' => '', 'sampleDocuments' => [ 'bucketName' => '', // REQUIRED 'keys' => [ // REQUIRED [ 'input' => '', 'output' => '', ], // ... ], ], 'status' => 'active|inactive', 'transformerId' => '', // REQUIRED ]);
Parameter Details
Members
ediType
Specifies the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
fileFormat
Specifies that the currently supported file formats for EDI transformations are JSON
and XML
.
inputConversion
Type: InputConversion structure
To update, specify the InputConversion
object, which contains the format options for the inbound transformation.
mapping
Specify the structure that contains the mapping template and its language (either XSLT or JSONATA).
mappingTemplate
Specifies the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
This parameter is available for backwards compatibility. Use the Mapping data type instead.
name
Specify a new name for the transformer, if you want to update it.
outputConversion
Type: OutputConversion structure
To update, specify the OutputConversion
object, which contains the format options for the outbound transformation.
sampleDocument
Specifies a sample EDI document that is used by a transformer as a guide for processing the EDI data.
sampleDocuments
Type: SampleDocuments structure
Specify a structure that contains the Amazon S3 bucket and an array of the corresponding keys used to identify the location for your sample documents.
status
Specifies the transformer's status. You can update the state of the transformer from inactive
to active
.
transformerId
Required: Yes
Type: string
Specifies the system-assigned unique identifier for the transformer.
Result Syntax
[ 'createdAt' => , 'ediType' => [ 'x12Details' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fileFormat' => 'XML|JSON|NOT_USED', 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '', 'templateLanguage' => 'XSLT|JSONATA', ], 'mappingTemplate' => '', 'modifiedAt' => , 'name' => '', 'outputConversion' => [ 'formatOptions' => [ 'x12' => [ 'transactionSet' => 'X12_100|X12_101|X12_102|X12_103|X12_104|X12_105|X12_106|X12_107|X12_108|X12_109|X12_110|X12_111|X12_112|X12_113|X12_120|X12_121|X12_124|X12_125|X12_126|X12_127|X12_128|X12_129|X12_130|X12_131|X12_132|X12_133|X12_135|X12_138|X12_139|X12_140|X12_141|X12_142|X12_143|X12_144|X12_146|X12_147|X12_148|X12_149|X12_150|X12_151|X12_152|X12_153|X12_154|X12_155|X12_157|X12_158|X12_159|X12_160|X12_161|X12_163|X12_170|X12_175|X12_176|X12_179|X12_180|X12_185|X12_186|X12_187|X12_188|X12_189|X12_190|X12_191|X12_194|X12_195|X12_196|X12_197|X12_198|X12_199|X12_200|X12_201|X12_202|X12_203|X12_204|X12_205|X12_206|X12_210|X12_211|X12_212|X12_213|X12_214|X12_215|X12_216|X12_217|X12_218|X12_219|X12_220|X12_222|X12_223|X12_224|X12_225|X12_227|X12_228|X12_240|X12_242|X12_244|X12_245|X12_248|X12_249|X12_250|X12_251|X12_252|X12_255|X12_256|X12_259|X12_260|X12_261|X12_262|X12_263|X12_264|X12_265|X12_266|X12_267|X12_268|X12_269|X12_270|X12_271|X12_272|X12_273|X12_274|X12_275|X12_276|X12_277|X12_278|X12_280|X12_283|X12_284|X12_285|X12_286|X12_288|X12_290|X12_300|X12_301|X12_303|X12_304|X12_309|X12_310|X12_311|X12_312|X12_313|X12_315|X12_317|X12_319|X12_322|X12_323|X12_324|X12_325|X12_326|X12_350|X12_352|X12_353|X12_354|X12_355|X12_356|X12_357|X12_358|X12_361|X12_362|X12_404|X12_410|X12_412|X12_414|X12_417|X12_418|X12_419|X12_420|X12_421|X12_422|X12_423|X12_424|X12_425|X12_426|X12_429|X12_431|X12_432|X12_433|X12_434|X12_435|X12_436|X12_437|X12_440|X12_451|X12_452|X12_453|X12_455|X12_456|X12_460|X12_463|X12_466|X12_468|X12_470|X12_475|X12_485|X12_486|X12_490|X12_492|X12_494|X12_500|X12_501|X12_503|X12_504|X12_511|X12_517|X12_521|X12_527|X12_536|X12_540|X12_561|X12_567|X12_568|X12_601|X12_602|X12_620|X12_625|X12_650|X12_715|X12_753|X12_754|X12_805|X12_806|X12_810|X12_811|X12_812|X12_813|X12_814|X12_815|X12_816|X12_818|X12_819|X12_820|X12_821|X12_822|X12_823|X12_824|X12_826|X12_827|X12_828|X12_829|X12_830|X12_831|X12_832|X12_833|X12_834|X12_835|X12_836|X12_837|X12_838|X12_839|X12_840|X12_841|X12_842|X12_843|X12_844|X12_845|X12_846|X12_847|X12_848|X12_849|X12_850|X12_851|X12_852|X12_853|X12_854|X12_855|X12_856|X12_857|X12_858|X12_859|X12_860|X12_861|X12_862|X12_863|X12_864|X12_865|X12_866|X12_867|X12_868|X12_869|X12_870|X12_871|X12_872|X12_873|X12_874|X12_875|X12_876|X12_877|X12_878|X12_879|X12_880|X12_881|X12_882|X12_883|X12_884|X12_885|X12_886|X12_887|X12_888|X12_889|X12_891|X12_893|X12_894|X12_895|X12_896|X12_920|X12_924|X12_925|X12_926|X12_928|X12_940|X12_943|X12_944|X12_945|X12_947|X12_980|X12_990|X12_993|X12_996|X12_997|X12_998|X12_999|X12_270_X279|X12_271_X279|X12_275_X210|X12_275_X211|X12_276_X212|X12_277_X212|X12_277_X214|X12_277_X364|X12_278_X217|X12_820_X218|X12_820_X306|X12_824_X186|X12_834_X220|X12_834_X307|X12_834_X318|X12_835_X221|X12_837_X222|X12_837_X223|X12_837_X224|X12_837_X291|X12_837_X292|X12_837_X298|X12_999_X231', 'version' => 'VERSION_4010|VERSION_4030|VERSION_4050|VERSION_4060|VERSION_5010|VERSION_5010_HIPAA', ], ], 'toFormat' => 'X12', ], 'sampleDocument' => '', 'sampleDocuments' => [ 'bucketName' => '', 'keys' => [ [ 'input' => '', 'output' => '', ], // ... ], ], 'status' => 'active|inactive', 'transformerArn' => '', 'transformerId' => '', ]
Result Details
Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the transformer.
ediType
Returns the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
fileFormat
Returns that the currently supported file formats for EDI transformations are JSON
and XML
.
inputConversion
Type: InputConversion structure
Returns the InputConversion
object, which contains the format options for the inbound transformation.
mapping
Returns the structure that contains the mapping template and its language (either XSLT or JSONATA).
mappingTemplate
Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
modifiedAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for last time the transformer was modified.
name
Required: Yes
Type: string
Returns the name of the transformer.
outputConversion
Type: OutputConversion structure
Returns the OutputConversion
object, which contains the format options for the outbound transformation.
sampleDocument
Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.
sampleDocuments
Type: SampleDocuments structure
Returns a structure that contains the Amazon S3 bucket and an array of the corresponding keys used to identify the location for your sample documents.
status
Required: Yes
Type: string
Returns the state of the newly created transformer. The transformer can be either active
or inactive
. For the transformer to be used in a capability, its status must active
.
transformerArn
Required: Yes
Type: string
Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.
transformerId
Required: Yes
Type: string
Returns the system-assigned unique identifier for the transformer.
Errors
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
You do not have sufficient access to perform this action.
Occurs when a B2BI object cannot be validated against a request from another object.
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
ServiceQuotaExceededException:
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Examples
Example 1: Sample UpdateTransformer call
result=result = result=client->updateTransformer([ 'name' => 'transformX12', 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '{}', 'templateLanguage' => 'JSONATA', ], 'sampleDocuments' => [ 'bucketName' => 'test-bucket', 'keys' => [ [ 'input' => 'sampleDoc.txt', ], ], ], 'status' => 'inactive', 'transformerId' => 'tr-974c129999f84d8c9', ]);
Result syntax:
[ 'name' => 'transformX12', 'createdAt' => , 'inputConversion' => [ 'formatOptions' => [ 'x12' => [ 'version' => 'VERSION_4010', 'transactionSet' => 'X12_110', ], ], 'fromFormat' => 'X12', ], 'mapping' => [ 'template' => '{}', 'templateLanguage' => 'JSONATA', ], 'modifiedAt' => , 'sampleDocuments' => [ 'bucketName' => 'test-bucket', 'keys' => [ [ 'input' => 'sampleDoc.txt', ], ], ], 'status' => 'inactive', 'transformerArn' => 'arn:aws:b2bi:us-west-2:123456789012:transformer/tr-974c129999f84d8c9', 'transformerId' => 'tr-974c129999f84d8c9', ]
Shapes
AccessDeniedException
Description
You do not have sufficient access to perform this action.
Members
message
Required: Yes
Type: string
CapabilityConfiguration
Description
A capability object. Currently, only EDI (electronic data interchange) capabilities are supported. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
Members
edi
Type: EdiConfiguration structure
An EDI (electronic data interchange) configuration object.
CapabilityOptions
Description
Contains the details for an Outbound EDI capability.
Members
outboundEdi
Type: OutboundEdiOptions structure
A structure that contains the outbound EDI options.
CapabilitySummary
Description
Returns the capability summary details. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.
Members
capabilityId
Required: Yes
Type: string
Returns a system-assigned unique identifier for the capability.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the capability.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp that identifies the most recent date and time that the capability was modified.
name
Required: Yes
Type: string
The display name of the capability.
type
Required: Yes
Type: string
Returns the type of the capability. Currently, only edi
is supported.
ConflictException
Description
A conflict exception is thrown when you attempt to delete a resource (such as a profile or a capability) that is being used by other resources.
Members
message
Required: Yes
Type: string
ConversionSource
Description
Describes the input for an outbound transformation.
Members
fileFormat
Required: Yes
Type: string
The format for the input file: either JSON or XML.
inputFile
Required: Yes
Type: InputFileSource structure
File to be converted
ConversionTarget
Description
Provide a sample of what the output of the transformation should look like.
Members
fileFormat
Required: Yes
Type: string
Currently, only X12 format is supported.
formatDetails
Type: ConversionTargetFormatDetails structure
A structure that contains the formatting details for the conversion target.
outputSampleFile
Type: OutputSampleFileSource structure
Customer uses this to provide a sample on what should file look like after conversion X12 EDI use case around this would be discovering the file syntax
ConversionTargetFormatDetails
Description
Contains a structure describing the X12 details for the conversion target.
Members
x12
Type: X12Details structure
A structure that contains the X12 transaction set and version. The X12 structure is used when the system transforms an EDI (electronic data interchange) file.
If an EDI input file contains more than one transaction, each transaction must have the same transaction set and version, for example 214/4010. If not, the transformer cannot parse the file.
EdiConfiguration
Description
Specifies the details for the EDI (electronic data interchange) transformation.
Members
capabilityDirection
Specifies whether this is capability is for inbound or outbound transformations.
inputLocation
Required: Yes
Type: S3Location structure
Contains the Amazon S3 bucket and prefix for the location of the input file, which is contained in an S3Location
object.
outputLocation
Required: Yes
Type: S3Location structure
Contains the Amazon S3 bucket and prefix for the location of the output file, which is contained in an S3Location
object.
transformerId
Required: Yes
Type: string
Returns the system-assigned unique identifier for the transformer.
type
Required: Yes
Type: EdiType structure
Returns the type of the capability. Currently, only edi
is supported.
EdiType
Description
Specifies the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
Members
x12Details
Type: X12Details structure
Returns the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
FormatOptions
Description
A structure that contains the X12 transaction set and version.
Members
x12
Type: X12Details structure
A structure that contains the X12 transaction set and version. The X12 structure is used when the system transforms an EDI (electronic data interchange) file.
If an EDI input file contains more than one transaction, each transaction must have the same transaction set and version, for example 214/4010. If not, the transformer cannot parse the file.
InputConversion
Description
Contains the input formatting options for an inbound transformer (takes an X12-formatted EDI document as input and converts it to JSON or XML.
Members
formatOptions
Type: FormatOptions structure
A structure that contains the formatting options for an inbound transformer.
fromFormat
Required: Yes
Type: string
The format for the transformer input: currently on X12
is supported.
InputFileSource
Description
The input file to use for an outbound transformation.
Members
fileContent
Specify the input contents, as a string, for the source of an outbound transformation.
InternalServerException
Description
This exception is thrown when an error occurs in the Amazon Web Services B2B Data Interchange service.
Members
message
Required: Yes
Type: string
retryAfterSeconds
The server attempts to retry a failed command.
Mapping
Description
Specifies the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
Members
template
A string that represents the mapping template, in the transformation language specified in templateLanguage
.
templateLanguage
Required: Yes
Type: string
The transformation language for the template, either XSLT or JSONATA.
OutboundEdiOptions
Description
A container for outbound EDI options.
Members
x12
Type: X12Envelope structure
A structure that contains an X12 envelope structure.
OutputConversion
Description
Contains the formatting options for an outbound transformer (takes JSON or XML as input and converts it to an EDI document (currently only X12 format is supported).
Members
formatOptions
Type: FormatOptions structure
A structure that contains the X12 transaction set and version for the transformer output.
toFormat
Required: Yes
Type: string
The format for the output from an outbound transformer: only X12 is currently supported.
OutputSampleFileSource
Description
Container for the location of a sample file used for outbound transformations.
Members
fileLocation
Type: S3Location structure
Specifies the details for the Amazon S3 file location that is being used with Amazon Web Services B2B Data Interchange. File locations in Amazon S3 are identified using a combination of the bucket and key.
PartnershipSummary
Description
A structure that contains the details for a partnership. A partnership represents the connection between you and your trading partner. It ties together a profile and one or more trading capabilities.
Members
capabilities
Returns one or more capabilities associated with this partnership.
capabilityOptions
Type: CapabilityOptions structure
Contains the details for an Outbound EDI capability.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp for creation date and time of the partnership.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp that identifies the most recent date and time that the partnership was modified.
name
Returns the name of the partnership.
partnershipId
Required: Yes
Type: string
Returns the unique, system-generated identifier for a partnership.
profileId
Required: Yes
Type: string
Returns the unique, system-generated identifier for the profile connected to this partnership.
tradingPartnerId
Returns the unique, system-generated identifier for a trading partner.
ProfileSummary
Description
Contains the details for a profile. A profile is the mechanism used to create the concept of a private network.
Members
businessName
Required: Yes
Type: string
Returns the name for the business associated with this profile.
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns the timestamp for creation date and time of the profile.
logGroupName
Returns the name of the logging group.
logging
Specifies whether or not logging is enabled for this profile.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns the timestamp that identifies the most recent date and time that the profile was modified.
name
Required: Yes
Type: string
Returns the display name for profile.
profileId
Required: Yes
Type: string
Returns the unique, system-generated identifier for the profile.
ResourceNotFoundException
Description
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
Members
message
Required: Yes
Type: string
S3Location
Description
Specifies the details for the Amazon S3 file location that is being used with Amazon Web Services B2B Data Interchange. File locations in Amazon S3 are identified using a combination of the bucket and key.
Members
bucketName
Specifies the name of the Amazon S3 bucket.
key
Specifies the Amazon S3 key for the file location.
SampleDocumentKeys
Description
An array of the Amazon S3 keys used to identify the location for your sample documents.
Members
input
An array of keys for your input sample documents.
output
An array of keys for your output sample documents.
SampleDocuments
Description
Describes a structure that contains the Amazon S3 bucket and an array of the corresponding keys used to identify the location for your sample documents.
Members
bucketName
Required: Yes
Type: string
Contains the Amazon S3 bucket that is used to hold your sample documents.
keys
Required: Yes
Type: Array of SampleDocumentKeys structures
Contains an array of the Amazon S3 keys used to identify the location for your sample documents.
ServiceQuotaExceededException
Description
Occurs when the calling command attempts to exceed one of the service quotas, for example trying to create a capability when you already have the maximum number of capabilities allowed.
Members
message
Required: Yes
Type: string
quotaCode
Required: Yes
Type: string
The quota that was exceeded, which caused the exception.
resourceId
Required: Yes
Type: string
The ID for the resource that exceeded the quota, which caused the exception.
resourceType
Required: Yes
Type: string
The resource type (profile, partnership, transformer, or capability) that exceeded the quota, which caused the exception.
serviceCode
Required: Yes
Type: string
The code responsible for exceeding the quota, which caused the exception.
Tag
Description
Creates a key-value pair for a specific resource. Tags are metadata that you can use to search for and group a resource for various purposes. You can apply tags to capabilities, partnerships, profiles and transformers. A tag key can take more than one value. For example, to group capabilities for accounting purposes, you might create a tag called Group
and assign the values Research
and Accounting
to that group.
Members
Key
Required: Yes
Type: string
Specifies the name assigned to the tag that you create.
Value
Required: Yes
Type: string
Contains one or more values that you assigned to the key name that you create.
TemplateDetails
Description
A data structure that contains the information to use when generating a mapping template.
Members
x12
Type: X12Details structure
A structure that contains the X12 transaction set and version. The X12 structure is used when the system transforms an EDI (electronic data interchange) file.
If an EDI input file contains more than one transaction, each transaction must have the same transaction set and version, for example 214/4010. If not, the transformer cannot parse the file.
ThrottlingException
Description
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
Members
message
Required: Yes
Type: string
retryAfterSeconds
The server attempts to retry a command that was throttled.
TransformerSummary
Description
Contains the details for a transformer object. A transformer can take an EDI file as input and transform it into a JSON-or XML-formatted document. Alternatively, a transformer can take a JSON-or XML-formatted document as input and transform it into an EDI file.
Members
createdAt
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp indicating when the transformer was created. For example, 2023-07-20T19:58:44.624Z
.
ediType
Returns the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
fileFormat
Returns that the currently supported file formats for EDI transformations are JSON
and XML
.
inputConversion
Type: InputConversion structure
Returns a structure that contains the format options for the transformation.
mapping
Returns the structure that contains the mapping template and its language (either XSLT or JSONATA).
mappingTemplate
Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
modifiedAt
Type: timestamp (string|DateTime or anything parsable by strtotime)
Returns a timestamp representing the date and time for the most recent change for the transformer object.
name
Required: Yes
Type: string
Returns the descriptive name for the transformer.
outputConversion
Type: OutputConversion structure
Returns the OutputConversion
object, which contains the format options for the outbound transformation.
sampleDocument
Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.
sampleDocuments
Type: SampleDocuments structure
Returns a structure that contains the Amazon S3 bucket and an array of the corresponding keys used to identify the location for your sample documents.
status
Required: Yes
Type: string
Returns the state of the newly created transformer. The transformer can be either active
or inactive
. For the transformer to be used in a capability, its status must active
.
transformerId
Required: Yes
Type: string
Returns the system-assigned unique identifier for the transformer.
ValidationException
Description
Occurs when a B2BI object cannot be validated against a request from another object.
Members
Message
Required: Yes
Type: string
X12Delimiters
Description
In X12 EDI messages, delimiters are used to mark the end of segments or elements, and are defined in the interchange control header. The delimiters are part of the message's syntax and divide up its different elements.
Members
componentSeparator
The component, or sub-element, separator. The default value is :
(colon).
dataElementSeparator
The data element separator. The default value is *
(asterisk).
segmentTerminator
The segment terminator. The default value is ~
(tilde).
X12Details
Description
A structure that contains the X12 transaction set and version. The X12 structure is used when the system transforms an EDI (electronic data interchange) file.
If an EDI input file contains more than one transaction, each transaction must have the same transaction set and version, for example 214/4010. If not, the transformer cannot parse the file.
Members
transactionSet
Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.
version
Returns the version to use for the specified X12 transaction set.
X12Envelope
Description
A wrapper structure for an X12 definition object.
the X12 envelope ensures the integrity of the data and the efficiency of the information exchange. The X12 message structure has hierarchical levels. From highest to the lowest, they are:
- Interchange Envelope
- Functional Group
- Transaction Set
Members
common
Type: X12OutboundEdiHeaders structure
A container for the X12 outbound EDI headers.
Description
Part of the X12 message structure. These are the functional group headers for the X12 EDI object.
Members
applicationReceiverCode
A value representing the code used to identify the party receiving a message, at position GS-03.
applicationSenderCode
A value representing the code used to identify the party transmitting a message, at position GS-02.
responsibleAgencyCode
A code that identifies the issuer of the standard, at position GS-07.
Description
In X12, the Interchange Control Header is the first segment of an EDI document and is part of the Interchange Envelope. It contains information about the sender and receiver, the date and time of transmission, and the X12 version being used. It also includes delivery information, such as the sender and receiver IDs.
Members
acknowledgmentRequestedCode
Located at position ISA-14 in the header. The value "1" indicates that the sender is requesting an interchange acknowledgment at receipt of the interchange. The value "0" is used otherwise.
receiverId
Located at position ISA-08 in the header. This value (along with the receiverIdQualifier
) identifies the intended recipient of the interchange.
receiverIdQualifier
Located at position ISA-07 in the header. Qualifier for the receiver ID. Together, the ID and qualifier uniquely identify the receiving trading partner.
repetitionSeparator
Located at position ISA-11 in the header. This string makes it easier when you need to group similar adjacent element values together without using extra segments.
This parameter is only honored for version greater than 401 (VERSION_4010
and higher).
For versions less than 401, this field is called StandardsId, in which case our service sets the value to U
.
senderId
Located at position ISA-06 in the header. This value (along with the senderIdQualifier
) identifies the sender of the interchange.
senderIdQualifier
Located at position ISA-05 in the header. Qualifier for the sender ID. Together, the ID and qualifier uniquely identify the sending trading partner.
usageIndicatorCode
Located at position ISA-15 in the header. Specifies how this interchange is being used:
T
indicates this interchange is for testing.P
indicates this interchange is for production.I
indicates this interchange is informational.
Description
A structure containing the details for an outbound EDI object.
Members
delimiters
Type: X12Delimiters structure
The delimiters, for example semicolon (;
), that separates sections of the headers for the X12 object.
functionalGroupHeaders
Type: X12FunctionalGroupHeaders structure
The functional group headers for the X12 object.
interchangeControlHeaders
Type: X12InterchangeControlHeaders structure
In X12 EDI messages, delimiters are used to mark the end of segments or elements, and are defined in the interchange control header.
validateEdi
Specifies whether or not to validate the EDI for this X12 object: TRUE
or FALSE
.