AWS B2B Data Interchange

2023/11/27 - AWS B2B Data Interchange - 27 new api methods

Changes  This is the initial SDK release for AWS B2B Data Interchange.

CreateTransformer (new) Link ¶

Creates a transformer. Transformers describe how to process the incoming EDI (electronic data interchange) documents, and extract the necessary information.

See also: AWS API Documentation

Request Syntax

client.create_transformer(
    name='string',
    fileFormat='XML'|'JSON',
    mappingTemplate='string',
    ediType={
        'x12Details': {
            'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
            'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
        }
    },
    sampleDocument='string',
    clientToken='string',
    tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type name:

string

param name:

[REQUIRED]

Specifies the name of the transformer, used to identify it.

type fileFormat:

string

param fileFormat:

[REQUIRED]

Specifies that the currently supported file formats for EDI transformations are JSON and XML.

type mappingTemplate:

string

param mappingTemplate:

[REQUIRED]

Specifies the name of the mapping template for the transformer. This template is used to convert the input document into the correct set of objects.

type ediType:

dict

param ediType:

[REQUIRED]

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.

  • x12Details (dict) --

    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.

    • transactionSet (string) --

      Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

    • version (string) --

      Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

type sampleDocument:

string

param sampleDocument:

Specifies a sample EDI document that is used by a transformer as a guide for processing the EDI data.

type clientToken:

string

param clientToken:

Reserved for future use.

This field is autopopulated if not provided.

type tags:

list

param tags:

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.

  • (dict) --

    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.

    • Key (string) -- [REQUIRED]

      Specifies the name assigned to the tag that you create.

    • Value (string) -- [REQUIRED]

      Contains one or more values that you assigned to the key name that you create.

rtype:

dict

returns:

Response Syntax

{
    'transformerId': 'string',
    'transformerArn': 'string',
    'name': 'string',
    'fileFormat': 'XML'|'JSON',
    'mappingTemplate': 'string',
    'status': 'active'|'inactive',
    'ediType': {
        'x12Details': {
            'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
            'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
        }
    },
    'sampleDocument': 'string',
    'createdAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • transformerId (string) --

      Returns the system-assigned unique identifier for the transformer.

    • transformerArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns the name of the transformer, used to identify it.

    • fileFormat (string) --

      Returns that the currently supported file formats for EDI transformations are JSON and XML.

    • mappingTemplate (string) --

      Returns the name of the mapping template for the transformer. This template is used to convert the input document into the correct set of objects.

    • status (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.

    • ediType (dict) --

      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.

      • x12Details (dict) --

        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.

        • transactionSet (string) --

          Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

        • version (string) --

          Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

    • sampleDocument (string) --

      Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the transformer.

DeleteProfile (new) Link ¶

Deletes the specified profile. Profiles contain basic information about you and your business.

See also: AWS API Documentation

Request Syntax

client.delete_profile(
    profileId='string'
)
type profileId:

string

param profileId:

[REQUIRED]

Specifies the unique, system-generated identifier for the profile.

returns:

None

DeletePartnership (new) Link ¶

Deletes the specified partnership. Partnerships link trading partners with your profile and a specific transformer, so that the EDI (electronic data interchange) documents that they upload to Amazon S3 can be processed according to their specifications.

See also: AWS API Documentation

Request Syntax

client.delete_partnership(
    partnershipId='string'
)
type partnershipId:

string

param partnershipId:

[REQUIRED]

Specifies the unique, system-generated identifier for a partnership.

returns:

None

TestParsing (new) Link ¶

Parses the input EDI (electronic data interchange) file.

See also: AWS API Documentation

Request Syntax

client.test_parsing(
    inputFile={
        'bucketName': 'string',
        'key': 'string'
    },
    fileFormat='XML'|'JSON',
    ediType={
        'x12Details': {
            'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
            'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
        }
    }
)
type inputFile:

dict

param inputFile:

[REQUIRED]

Specifies an S3Location object, which contains the Amazon S3 bucket and prefix for the location of the input file.

  • bucketName (string) --

    Specifies the name of the Amazon S3 bucket.

  • key (string) --

    Specifies the Amazon S3 key for the file location.

type fileFormat:

string

param fileFormat:

[REQUIRED]

Specifies that the currently supported file formats for EDI transformations are JSON and XML.

type ediType:

dict

param ediType:

[REQUIRED]

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.

  • x12Details (dict) --

    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.

    • transactionSet (string) --

      Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

    • version (string) --

      Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

rtype:

dict

returns:

Response Syntax

{
    'parsedFileContent': 'string'
}

Response Structure

  • (dict) --

    • parsedFileContent (string) --

      Returns the contents of the input file being tested, parsed according to the specified EDI (electronic data interchange) type.

UpdateCapability (new) Link ¶

Updates some of the parameters for a capability, based on the specified parameters. Capabilities contain the information necessary to process incoming EDI (electronic data interchange) documents.

See also: AWS API Documentation

Request Syntax

client.update_capability(
    capabilityId='string',
    name='string',
    configuration={
        'edi': {
            'type': {
                'x12Details': {
                    'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
                    'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
                }
            },
            'inputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'outputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'transformerId': 'string'
        }
    },
    instructionsDocuments=[
        {
            'bucketName': 'string',
            'key': 'string'
        },
    ]
)
type capabilityId:

string

param capabilityId:

[REQUIRED]

Specifies a system-assigned unique identifier for the capability.

type name:

string

param name:

Specifies a new name for the capability, to replace the existing name.

type configuration:

dict

param configuration:

Specifies a structure that contains the details for a capability.

  • edi (dict) --

    An EDI (electronic data interchange) configuration object.

    • type (dict) -- [REQUIRED]

      Returns the type of the capability. Currently, only edi is supported.

      • x12Details (dict) --

        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.

        • transactionSet (string) --

          Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

        • version (string) --

          Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

    • inputLocation (dict) -- [REQUIRED]

      Contains the Amazon S3 bucket and prefix for the location of the input file, which is contained in an S3Location object.

      • bucketName (string) --

        Specifies the name of the Amazon S3 bucket.

      • key (string) --

        Specifies the Amazon S3 key for the file location.

    • outputLocation (dict) -- [REQUIRED]

      Contains the Amazon S3 bucket and prefix for the location of the output file, which is contained in an S3Location object.

      • bucketName (string) --

        Specifies the name of the Amazon S3 bucket.

      • key (string) --

        Specifies the Amazon S3 key for the file location.

    • transformerId (string) -- [REQUIRED]

      Returns the system-assigned unique identifier for the transformer.

type instructionsDocuments:

list

param instructionsDocuments:

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.

  • (dict) --

    Specifies the details for the Amazon S3 file location that is being used with Amazon Web Services B2BI Data Interchange. File locations in Amazon S3 are identified using a combination of the bucket and key.

    • bucketName (string) --

      Specifies the name of the Amazon S3 bucket.

    • key (string) --

      Specifies the Amazon S3 key for the file location.

rtype:

dict

returns:

Response Syntax

{
    'capabilityId': 'string',
    'capabilityArn': 'string',
    'name': 'string',
    'type': 'edi',
    'configuration': {
        'edi': {
            'type': {
                'x12Details': {
                    'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
                    'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
                }
            },
            'inputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'outputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'transformerId': 'string'
        }
    },
    'instructionsDocuments': [
        {
            'bucketName': 'string',
            'key': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • capabilityId (string) --

      Returns a system-assigned unique identifier for the capability.

    • capabilityArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns the name of the capability, used to identify it.

    • type (string) --

      Returns the type of the capability. Currently, only edi is supported.

    • configuration (dict) --

      Returns a structure that contains the details for a capability.

      • edi (dict) --

        An EDI (electronic data interchange) configuration object.

        • type (dict) --

          Returns the type of the capability. Currently, only edi is supported.

          • x12Details (dict) --

            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.

            • transactionSet (string) --

              Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

            • version (string) --

              Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

        • inputLocation (dict) --

          Contains the Amazon S3 bucket and prefix for the location of the input file, which is contained in an S3Location object.

          • bucketName (string) --

            Specifies the name of the Amazon S3 bucket.

          • key (string) --

            Specifies the Amazon S3 key for the file location.

        • outputLocation (dict) --

          Contains the Amazon S3 bucket and prefix for the location of the output file, which is contained in an S3Location object.

          • bucketName (string) --

            Specifies the name of the Amazon S3 bucket.

          • key (string) --

            Specifies the Amazon S3 key for the file location.

        • transformerId (string) --

          Returns the system-assigned unique identifier for the transformer.

    • instructionsDocuments (list) --

      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.

      • (dict) --

        Specifies the details for the Amazon S3 file location that is being used with Amazon Web Services B2BI Data Interchange. File locations in Amazon S3 are identified using a combination of the bucket and key.

        • bucketName (string) --

          Specifies the name of the Amazon S3 bucket.

        • key (string) --

          Specifies the Amazon S3 key for the file location.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the capability.

    • modifiedAt (datetime) --

      Returns a timestamp for last time the capability was modified.

ListProfiles (new) Link ¶

Lists the profiles associated with your Amazon Web Services account for your current or specified region. Profiles contain basic information about you and your business.

See also: AWS API Documentation

Request Syntax

client.list_profiles(
    nextToken='string',
    maxResults=123
)
type nextToken:

string

param 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.

type maxResults:

integer

param maxResults:

Specifies the maximum number of profiles to return.

rtype:

dict

returns:

Response Syntax

{
    'profiles': [
        {
            'profileId': 'string',
            'name': 'string',
            'businessName': 'string',
            'logging': 'ENABLED'|'DISABLED',
            'logGroupName': 'string',
            'createdAt': datetime(2015, 1, 1),
            'modifiedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • profiles (list) --

      Returns an array of ProfileSummary objects.

      • (dict) --

        Contains the details for a profile. Profiles contain basic information about you and your business.

        • profileId (string) --

          Returns the unique, system-generated identifier for the profile.

        • name (string) --

          Returns the display name for profile.

        • businessName (string) --

          Returns the name for the business associated with this profile.

        • logging (string) --

          Specifies whether or not logging is enabled for this profile.

        • logGroupName (string) --

          Returns the name of the logging group.

        • createdAt (datetime) --

          Returns the timestamp for creation date and time of the profile.

        • modifiedAt (datetime) --

          Returns the timestamp that identifies the most recent date and time that the profile was modified.

    • nextToken (string) --

      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.

ListTransformers (new) Link ¶

Lists the available transformers. Transformers describe how to process the incoming EDI (electronic data interchange) documents, and extract the necessary information.

See also: AWS API Documentation

Request Syntax

client.list_transformers(
    nextToken='string',
    maxResults=123
)
type nextToken:

string

param 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.

type maxResults:

integer

param maxResults:

Specifies the number of items to return for the API response.

rtype:

dict

returns:

Response Syntax

{
    'transformers': [
        {
            'transformerId': 'string',
            'name': 'string',
            'fileFormat': 'XML'|'JSON',
            'mappingTemplate': 'string',
            'status': 'active'|'inactive',
            'ediType': {
                'x12Details': {
                    'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
                    'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
                }
            },
            'sampleDocument': 'string',
            'createdAt': datetime(2015, 1, 1),
            'modifiedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • transformers (list) --

      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.

      • (dict) --

        Contains the details for a transformer object. Transformers describe how to process the incoming EDI (electronic data interchange) documents, and extract the necessary information.

        • transformerId (string) --

          Returns the system-assigned unique identifier for the transformer.

        • name (string) --

          Returns the descriptive name for the transformer.

        • fileFormat (string) --

          Returns that the currently supported file formats for EDI transformations are JSON and XML.

        • mappingTemplate (string) --

          Returns the name of the mapping template for the transformer. This template is used to convert the input document into the correct set of objects.

        • status (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.

        • ediType (dict) --

          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.

          • x12Details (dict) --

            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.

            • transactionSet (string) --

              Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

            • version (string) --

              Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

        • sampleDocument (string) --

          Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.

        • createdAt (datetime) --

          Returns a timestamp indicating when the transformer was created. For example, 2023-07-20T19:58:44.624Z.

        • modifiedAt (datetime) --

          Returns a timestamp representing the date and time for the most recent change for the transformer object.

    • nextToken (string) --

      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.

DeleteTransformer (new) Link ¶

Deletes the specified transformer. Transformers describe how to process the incoming EDI (electronic data interchange) documents, and extract the necessary information.

See also: AWS API Documentation

Request Syntax

client.delete_transformer(
    transformerId='string'
)
type transformerId:

string

param transformerId:

[REQUIRED]

Specifies the system-assigned unique identifier for the transformer.

returns:

None

GetPartnership (new) Link ¶

Retrieves the details for a partnership, based on the partner and profile IDs specified. Partnerships link trading partners with your profile and a specific transformer, so that the EDI (electronic data interchange) documents that they upload to Amazon S3 can be processed according to their specifications.

See also: AWS API Documentation

Request Syntax

client.get_partnership(
    partnershipId='string'
)
type partnershipId:

string

param partnershipId:

[REQUIRED]

Specifies the unique, system-generated identifier for a partnership.

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'partnershipId': 'string',
    'partnershipArn': 'string',
    'name': 'string',
    'email': 'string',
    'phone': 'string',
    'capabilities': [
        'string',
    ],
    'tradingPartnerId': 'string',
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • profileId (string) --

      Returns the unique, system-generated identifier for the profile connected to this partnership.

    • partnershipId (string) --

      Returns the unique, system-generated identifier for a partnership.

    • partnershipArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns the display name of the partnership

    • email (string) --

      Returns the email address associated with this trading partner.

    • phone (string) --

      Returns the phone number associated with the partnership.

    • capabilities (list) --

      Returns one or more capabilities associated with this partnership.

      • (string) --

    • tradingPartnerId (string) --

      Returns the unique identifier for the partner for this partnership.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the partnership.

    • modifiedAt (datetime) --

      Returns a timestamp that identifies the most recent date and time that the partnership was modified.

GetProfile (new) Link ¶

Retrieves the details for the profile specified by the profile ID. Profiles contain basic information about you and your business.

See also: AWS API Documentation

Request Syntax

client.get_profile(
    profileId='string'
)
type profileId:

string

param profileId:

[REQUIRED]

Specifies the unique, system-generated identifier for the profile.

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'profileArn': 'string',
    'name': 'string',
    'email': 'string',
    'phone': 'string',
    'businessName': 'string',
    'logging': 'ENABLED'|'DISABLED',
    'logGroupName': 'string',
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • profileId (string) --

      Returns the unique, system-generated identifier for the profile.

    • profileArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns the name of the profile, used to identify it.

    • email (string) --

      Returns the email address associated with this customer profile.

    • phone (string) --

      Returns the phone number associated with the profile.

    • businessName (string) --

      Returns the name for the business associated with this profile.

    • logging (string) --

      Returns whether or not logging is enabled for this profile.

    • logGroupName (string) --

      Returns the name of the logging group.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the transformer.

    • modifiedAt (datetime) --

      Returns a timestamp for last time the profile was modified.

TagResource (new) Link ¶

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.

See also: AWS API Documentation

Request Syntax

client.tag_resource(
    ResourceARN='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type ResourceARN:

string

param ResourceARN:

[REQUIRED]

Specifies an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

type Tags:

list

param Tags:

[REQUIRED]

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.

  • (dict) --

    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.

    • Key (string) -- [REQUIRED]

      Specifies the name assigned to the tag that you create.

    • Value (string) -- [REQUIRED]

      Contains one or more values that you assigned to the key name that you create.

returns:

None

ListCapabilities (new) Link ¶

Lists the capabilities associated with your Amazon Web Services account for your current or specified region. Capabilities contain the information necessary to process incoming EDI (electronic data interchange) documents.

See also: AWS API Documentation

Request Syntax

client.list_capabilities(
    nextToken='string',
    maxResults=123
)
type nextToken:

string

param 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.

type maxResults:

integer

param maxResults:

Specifies the maximum number of capabilities to return.

rtype:

dict

returns:

Response Syntax

{
    'capabilities': [
        {
            'capabilityId': 'string',
            'name': 'string',
            'type': 'edi',
            'createdAt': datetime(2015, 1, 1),
            'modifiedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • capabilities (list) --

      Returns one or more capabilities associated with this partnership.

      • (dict) --

        Returns the capability summary details. Capabilities contain the information necessary to process incoming EDI (electronic data interchange) documents.

        • capabilityId (string) --

          Returns a system-assigned unique identifier for the capability.

        • name (string) --

          The display name of the capability.

        • type (string) --

          Returns the type of the capability. Currently, only edi is supported.

        • createdAt (datetime) --

          Returns a timestamp for creation date and time of the capability.

        • modifiedAt (datetime) --

          Returns a timestamp that identifies the most recent date and time that the capability was modified.

    • nextToken (string) --

      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.

GetTransformer (new) Link ¶

Retrieves the details for the transformer specified by the transformer ID. Transformers describe how to process the incoming EDI (electronic data interchange) documents, and extract the necessary information.

See also: AWS API Documentation

Request Syntax

client.get_transformer(
    transformerId='string'
)
type transformerId:

string

param transformerId:

[REQUIRED]

Specifies the system-assigned unique identifier for the transformer.

rtype:

dict

returns:

Response Syntax

{
    'transformerId': 'string',
    'transformerArn': 'string',
    'name': 'string',
    'fileFormat': 'XML'|'JSON',
    'mappingTemplate': 'string',
    'status': 'active'|'inactive',
    'ediType': {
        'x12Details': {
            'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
            'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
        }
    },
    'sampleDocument': 'string',
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • transformerId (string) --

      Returns the system-assigned unique identifier for the transformer.

    • transformerArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns the name of the transformer, used to identify it.

    • fileFormat (string) --

      Returns that the currently supported file formats for EDI transformations are JSON and XML.

    • mappingTemplate (string) --

      Returns the name of the mapping template for the transformer. This template is used to convert the input document into the correct set of objects.

    • status (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.

    • ediType (dict) --

      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.

      • x12Details (dict) --

        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.

        • transactionSet (string) --

          Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

        • version (string) --

          Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

    • sampleDocument (string) --

      Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the transformer.

    • modifiedAt (datetime) --

      Returns a timestamp for last time the transformer was modified.

ListPartnerships (new) Link ¶

Lists the partnerships associated with your Amazon Web Services account for your current or specified region. Partnerships link trading partners with your profile and a specific transformer, so that the EDI (electronic data interchange) documents that they upload to Amazon S3 can be processed according to their specifications.

See also: AWS API Documentation

Request Syntax

client.list_partnerships(
    profileId='string',
    nextToken='string',
    maxResults=123
)
type profileId:

string

param profileId:

Specifies the unique, system-generated identifier for the profile connected to this partnership.

type nextToken:

string

param 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.

type maxResults:

integer

param maxResults:

Specifies the maximum number of capabilities to return.

rtype:

dict

returns:

Response Syntax

{
    'partnerships': [
        {
            'profileId': 'string',
            'partnershipId': 'string',
            'name': 'string',
            'capabilities': [
                'string',
            ],
            'tradingPartnerId': 'string',
            'createdAt': datetime(2015, 1, 1),
            'modifiedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • partnerships (list) --

      Specifies a list of your partnerships.

      • (dict) --

        A structure that contains the details for a partnership. Partnerships link trading partners with your profile and a specific transformer, so that the EDI (electronic data interchange) documents that they upload to Amazon S3 can be processed according to their specifications.

        • profileId (string) --

          Returns the unique, system-generated identifier for the profile connected to this partnership.

        • partnershipId (string) --

          Returns the unique, system-generated identifier for a partnership.

        • name (string) --

          Returns the name of the partnership.

        • capabilities (list) --

          Returns one or more capabilities associated with this partnership.

          • (string) --

        • tradingPartnerId (string) --

          Returns the unique, system-generated identifier for a trading partner.

        • createdAt (datetime) --

          Returns a timestamp for creation date and time of the partnership.

        • modifiedAt (datetime) --

          Returns a timestamp that identifies the most recent date and time that the partnership was modified.

    • nextToken (string) --

      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.

UpdatePartnership (new) Link ¶

Updates some of the parameters for a partnership between a customer and trading partner. Partnerships link trading partners with your profile and a specific transformer, so that the EDI (electronic data interchange) documents that they upload to Amazon S3 can be processed according to their specifications.

See also: AWS API Documentation

Request Syntax

client.update_partnership(
    partnershipId='string',
    name='string',
    capabilities=[
        'string',
    ]
)
type partnershipId:

string

param partnershipId:

[REQUIRED]

Specifies the unique, system-generated identifier for a partnership.

type name:

string

param name:

The name of the partnership, used to identify it.

type capabilities:

list

param capabilities:

List of the capabilities associated with this partnership.

  • (string) --

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'partnershipId': 'string',
    'partnershipArn': 'string',
    'name': 'string',
    'email': 'string',
    'phone': 'string',
    'capabilities': [
        'string',
    ],
    'tradingPartnerId': 'string',
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • profileId (string) --

      Returns the unique, system-generated identifier for the profile connected to this partnership.

    • partnershipId (string) --

      Returns the unique, system-generated identifier for a partnership.

    • partnershipArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      The name of the partnership, used to identify it.

    • email (string) --

      Returns the email address associated with this trading partner.

    • phone (string) --

      Returns the phone number associated with the partnership.

    • capabilities (list) --

      Returns one or more capabilities associated with this partnership.

      • (string) --

    • tradingPartnerId (string) --

      Returns the unique, system-generated identifier for a trading partner.

    • createdAt (datetime) --

      Returns a timestamp that identifies the most recent date and time that the partnership was modified.

    • modifiedAt (datetime) --

      Returns a timestamp that identifies the most recent date and time that the partnership was modified.

CreatePartnership (new) Link ¶

Creates a partnership between a customer and a trading partner, based on the supplied parameters. Partnerships link trading partners with your profile and a specific transformer, so that the EDI (electronic data interchange) documents that they upload to Amazon S3 can be processed according to their specifications.

See also: AWS API Documentation

Request Syntax

client.create_partnership(
    profileId='string',
    name='string',
    email='string',
    phone='string',
    capabilities=[
        'string',
    ],
    clientToken='string',
    tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type profileId:

string

param profileId:

[REQUIRED]

Specifies the unique, system-generated identifier for the profile connected to this partnership.

type name:

string

param name:

[REQUIRED]

Specifies a descriptive name for the partnership.

type email:

string

param email:

[REQUIRED]

Specifies the email address associated with this trading partner.

type phone:

string

param phone:

Specifies the phone number associated with the partnership.

type capabilities:

list

param capabilities:

Specifies a list of the capabilities associated with this partnership.

  • (string) --

type clientToken:

string

param clientToken:

Reserved for future use.

This field is autopopulated if not provided.

type tags:

list

param tags:

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.

  • (dict) --

    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.

    • Key (string) -- [REQUIRED]

      Specifies the name assigned to the tag that you create.

    • Value (string) -- [REQUIRED]

      Contains one or more values that you assigned to the key name that you create.

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'partnershipId': 'string',
    'partnershipArn': 'string',
    'name': 'string',
    'email': 'string',
    'phone': 'string',
    'capabilities': [
        'string',
    ],
    'tradingPartnerId': 'string',
    'createdAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • profileId (string) --

      Returns the unique, system-generated identifier for the profile connected to this partnership.

    • partnershipId (string) --

      Returns the unique, system-generated identifier for a partnership.

    • partnershipArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns a descriptive name for the partnership.

    • email (string) --

      Returns the email address associated with this trading partner.

    • phone (string) --

      Returns the phone number associated with the partnership.

    • capabilities (list) --

      Returns one or more capabilities associated with this partnership.

      • (string) --

    • tradingPartnerId (string) --

      Returns the unique, system-generated identifier for a trading partner.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the partnership.

ListTagsForResource (new) Link ¶

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.

See also: AWS API Documentation

Request Syntax

client.list_tags_for_resource(
    ResourceARN='string'
)
type ResourceARN:

string

param ResourceARN:

[REQUIRED]

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.

rtype:

dict

returns:

Response Syntax

{
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • Tags (list) --

      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.

      • (dict) --

        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.

        • Key (string) --

          Specifies the name assigned to the tag that you create.

        • Value (string) --

          Contains one or more values that you assigned to the key name that you create.

StartTransformerJob (new) Link ¶

Runs a job, using a transformer, to parse input EDI (electronic data interchange) file into the output structures used by Amazon Web Services B2BI Data Interchange.

See also: AWS API Documentation

Request Syntax

client.start_transformer_job(
    inputFile={
        'bucketName': 'string',
        'key': 'string'
    },
    outputLocation={
        'bucketName': 'string',
        'key': 'string'
    },
    transformerId='string',
    clientToken='string'
)
type inputFile:

dict

param inputFile:

[REQUIRED]

Specifies the location of the input file for the transformation. The location consists of an Amazon S3 bucket and prefix.

  • bucketName (string) --

    Specifies the name of the Amazon S3 bucket.

  • key (string) --

    Specifies the Amazon S3 key for the file location.

type outputLocation:

dict

param outputLocation:

[REQUIRED]

Specifies the location of the output file for the transformation. The location consists of an Amazon S3 bucket and prefix.

  • bucketName (string) --

    Specifies the name of the Amazon S3 bucket.

  • key (string) --

    Specifies the Amazon S3 key for the file location.

type transformerId:

string

param transformerId:

[REQUIRED]

Specifies the system-assigned unique identifier for the transformer.

type clientToken:

string

param clientToken:

Reserved for future use.

This field is autopopulated if not provided.

rtype:

dict

returns:

Response Syntax

{
    'transformerJobId': 'string'
}

Response Structure

  • (dict) --

    • transformerJobId (string) --

      Returns the unique, system-generated identifier for a transformer run.

UpdateTransformer (new) Link ¶

Updates the specified parameters for a transformer. Transformers describe how to process the incoming EDI (electronic data interchange) documents, and extract the necessary information.

See also: AWS API Documentation

Request Syntax

client.update_transformer(
    transformerId='string',
    name='string',
    fileFormat='XML'|'JSON',
    mappingTemplate='string',
    status='active'|'inactive',
    ediType={
        'x12Details': {
            'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
            'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
        }
    },
    sampleDocument='string'
)
type transformerId:

string

param transformerId:

[REQUIRED]

Specifies the system-assigned unique identifier for the transformer.

type name:

string

param name:

Specify a new name for the transformer, if you want to update it.

type fileFormat:

string

param fileFormat:

Specifies that the currently supported file formats for EDI transformations are JSON and XML.

type mappingTemplate:

string

param mappingTemplate:

Specifies the name of the mapping template for the transformer. This template is used to convert the input document into the correct set of objects.

type status:

string

param status:

Specifies the transformer's status. You can update the state of the transformer, from active to inactive, or inactive to active.

type ediType:

dict

param 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.

  • x12Details (dict) --

    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.

    • transactionSet (string) --

      Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

    • version (string) --

      Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

type sampleDocument:

string

param sampleDocument:

Specifies a sample EDI document that is used by a transformer as a guide for processing the EDI data.

rtype:

dict

returns:

Response Syntax

{
    'transformerId': 'string',
    'transformerArn': 'string',
    'name': 'string',
    'fileFormat': 'XML'|'JSON',
    'mappingTemplate': 'string',
    'status': 'active'|'inactive',
    'ediType': {
        'x12Details': {
            'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
            'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
        }
    },
    'sampleDocument': 'string',
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • transformerId (string) --

      Returns the system-assigned unique identifier for the transformer.

    • transformerArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns the name of the transformer.

    • fileFormat (string) --

      Returns that the currently supported file formats for EDI transformations are JSON and XML.

    • mappingTemplate (string) --

      Returns the name of the mapping template for the transformer. This template is used to convert the input document into the correct set of objects.

    • status (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.

    • ediType (dict) --

      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.

      • x12Details (dict) --

        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.

        • transactionSet (string) --

          Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

        • version (string) --

          Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

    • sampleDocument (string) --

      Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the transformer.

    • modifiedAt (datetime) --

      Returns a timestamp for last time the transformer was modified.

CreateProfile (new) Link ¶

Creates a customer profile. You can have up to five customer profiles, each representing a distinct private network. Profiles contain basic information about you and your business.

See also: AWS API Documentation

Request Syntax

client.create_profile(
    name='string',
    email='string',
    phone='string',
    businessName='string',
    logging='ENABLED'|'DISABLED',
    clientToken='string',
    tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type name:

string

param name:

[REQUIRED]

Specifies the name of the profile.

type email:

string

param email:

Specifies the email address associated with this customer profile.

type phone:

string

param phone:

[REQUIRED]

Specifies the phone number associated with the profile.

type businessName:

string

param businessName:

[REQUIRED]

Specifies the name for the business associated with this profile.

type logging:

string

param logging:

[REQUIRED]

Specifies whether or not logging is enabled for this profile.

type clientToken:

string

param clientToken:

Reserved for future use.

This field is autopopulated if not provided.

type tags:

list

param tags:

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.

  • (dict) --

    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.

    • Key (string) -- [REQUIRED]

      Specifies the name assigned to the tag that you create.

    • Value (string) -- [REQUIRED]

      Contains one or more values that you assigned to the key name that you create.

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'profileArn': 'string',
    'name': 'string',
    'businessName': 'string',
    'phone': 'string',
    'email': 'string',
    'logging': 'ENABLED'|'DISABLED',
    'logGroupName': 'string',
    'createdAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • profileId (string) --

      Returns the unique, system-generated identifier for the profile.

    • profileArn (string) --

      Returns an Amazon Resource Name (ARN) for the profile.

    • name (string) --

      Returns the name of the profile, used to identify it.

    • businessName (string) --

      Returns the name for the business associated with this profile.

    • phone (string) --

      Returns the phone number associated with the profile.

    • email (string) --

      Returns the email address associated with this customer profile.

    • logging (string) --

      Returns whether or not logging is turned on for this profile.

    • logGroupName (string) --

      Returns the name of the logging group.

    • createdAt (datetime) --

      Returns a timestamp representing the time the profile was created.

TestMapping (new) Link ¶

Maps the input file according to the provided template file.

See also: AWS API Documentation

Request Syntax

client.test_mapping(
    inputFileContent='string',
    mappingTemplate='string',
    fileFormat='XML'|'JSON'
)
type inputFileContent:

string

param inputFileContent:

[REQUIRED]

Specify the EDI (electronic data interchange) file that is used as input for the transform.

type mappingTemplate:

string

param mappingTemplate:

[REQUIRED]

Specifies the name of the mapping template for the transformer. This template is used to convert the input document into the correct set of objects.

type fileFormat:

string

param fileFormat:

[REQUIRED]

Specifies that the currently supported file formats for EDI transformations are JSON and XML.

rtype:

dict

returns:

Response Syntax

{
    'mappedFileContent': 'string'
}

Response Structure

  • (dict) --

    • mappedFileContent (string) --

      Returns a string for the mapping that can be used to identify the mapping. Similar to a fingerprint

GetCapability (new) Link ¶

Retrieves the details for the specified capability. Capabilities contain the information necessary to process incoming EDI (electronic data interchange) documents.

See also: AWS API Documentation

Request Syntax

client.get_capability(
    capabilityId='string'
)
type capabilityId:

string

param capabilityId:

[REQUIRED]

Specifies a system-assigned unique identifier for the capability.

rtype:

dict

returns:

Response Syntax

{
    'capabilityId': 'string',
    'capabilityArn': 'string',
    'name': 'string',
    'type': 'edi',
    'configuration': {
        'edi': {
            'type': {
                'x12Details': {
                    'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
                    'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
                }
            },
            'inputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'outputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'transformerId': 'string'
        }
    },
    'instructionsDocuments': [
        {
            'bucketName': 'string',
            'key': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • capabilityId (string) --

      Returns a system-assigned unique identifier for the capability.

    • capabilityArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns the name of the capability, used to identify it.

    • type (string) --

      Returns the type of the capability. Currently, only edi is supported.

    • configuration (dict) --

      Returns a structure that contains the details for a capability.

      • edi (dict) --

        An EDI (electronic data interchange) configuration object.

        • type (dict) --

          Returns the type of the capability. Currently, only edi is supported.

          • x12Details (dict) --

            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.

            • transactionSet (string) --

              Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

            • version (string) --

              Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

        • inputLocation (dict) --

          Contains the Amazon S3 bucket and prefix for the location of the input file, which is contained in an S3Location object.

          • bucketName (string) --

            Specifies the name of the Amazon S3 bucket.

          • key (string) --

            Specifies the Amazon S3 key for the file location.

        • outputLocation (dict) --

          Contains the Amazon S3 bucket and prefix for the location of the output file, which is contained in an S3Location object.

          • bucketName (string) --

            Specifies the name of the Amazon S3 bucket.

          • key (string) --

            Specifies the Amazon S3 key for the file location.

        • transformerId (string) --

          Returns the system-assigned unique identifier for the transformer.

    • instructionsDocuments (list) --

      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.

      • (dict) --

        Specifies the details for the Amazon S3 file location that is being used with Amazon Web Services B2BI Data Interchange. File locations in Amazon S3 are identified using a combination of the bucket and key.

        • bucketName (string) --

          Specifies the name of the Amazon S3 bucket.

        • key (string) --

          Specifies the Amazon S3 key for the file location.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the capability.

    • modifiedAt (datetime) --

      Returns a timestamp for last time the capability was modified.

UpdateProfile (new) Link ¶

Updates the specified parameters for a profile. Profiles contain basic information about you and your business.

See also: AWS API Documentation

Request Syntax

client.update_profile(
    profileId='string',
    name='string',
    email='string',
    phone='string',
    businessName='string'
)
type profileId:

string

param profileId:

[REQUIRED]

Specifies the unique, system-generated identifier for the profile.

type name:

string

param name:

The name of the profile, used to identify it.

type email:

string

param email:

Specifies the email address associated with this customer profile.

type phone:

string

param phone:

Specifies the phone number associated with the profile.

type businessName:

string

param businessName:

Specifies the name for the business associated with this profile.

rtype:

dict

returns:

Response Syntax

{
    'profileId': 'string',
    'profileArn': 'string',
    'name': 'string',
    'email': 'string',
    'phone': 'string',
    'businessName': 'string',
    'logging': 'ENABLED'|'DISABLED',
    'logGroupName': 'string',
    'createdAt': datetime(2015, 1, 1),
    'modifiedAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • profileId (string) --

      Returns the unique, system-generated identifier for the profile.

    • profileArn (string) --

      Returns an Amazon Resource Name (ARN) for the profile.

    • name (string) --

      Returns the name of the profile.

    • email (string) --

      Returns the email address associated with this customer profile.

    • phone (string) --

      Returns the phone number associated with the profile.

    • businessName (string) --

      Returns the name for the business associated with this profile.

    • logging (string) --

      Specifies whether or not logging is enabled for this profile.

    • logGroupName (string) --

      Returns the name of the logging group.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the profile.

    • modifiedAt (datetime) --

      Returns a timestamp for last time the profile was modified.

UntagResource (new) Link ¶

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.

See also: AWS API Documentation

Request Syntax

client.untag_resource(
    ResourceARN='string',
    TagKeys=[
        'string',
    ]
)
type ResourceARN:

string

param ResourceARN:

[REQUIRED]

Specifies an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

type TagKeys:

list

param TagKeys:

[REQUIRED]

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.

  • (string) --

returns:

None

DeleteCapability (new) Link ¶

Deletes the specified capability. Capabilities contain the information necessary to process incoming EDI (electronic data interchange) documents.

See also: AWS API Documentation

Request Syntax

client.delete_capability(
    capabilityId='string'
)
type capabilityId:

string

param capabilityId:

[REQUIRED]

Specifies a system-assigned unique identifier for the capability.

returns:

None

CreateCapability (new) Link ¶

Instantiates a capability based on the specified parameters. Capabilities contain the information necessary to process incoming EDI (electronic data interchange) documents.

See also: AWS API Documentation

Request Syntax

client.create_capability(
    name='string',
    type='edi',
    configuration={
        'edi': {
            'type': {
                'x12Details': {
                    'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
                    'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
                }
            },
            'inputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'outputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'transformerId': 'string'
        }
    },
    instructionsDocuments=[
        {
            'bucketName': 'string',
            'key': 'string'
        },
    ],
    clientToken='string',
    tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type name:

string

param name:

[REQUIRED]

Specifies the name of the capability, used to identify it.

type type:

string

param type:

[REQUIRED]

Specifies the type of the capability. Currently, only edi is supported.

type configuration:

dict

param configuration:

[REQUIRED]

Specifies a structure that contains the details for a capability.

  • edi (dict) --

    An EDI (electronic data interchange) configuration object.

    • type (dict) -- [REQUIRED]

      Returns the type of the capability. Currently, only edi is supported.

      • x12Details (dict) --

        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.

        • transactionSet (string) --

          Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

        • version (string) --

          Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

    • inputLocation (dict) -- [REQUIRED]

      Contains the Amazon S3 bucket and prefix for the location of the input file, which is contained in an S3Location object.

      • bucketName (string) --

        Specifies the name of the Amazon S3 bucket.

      • key (string) --

        Specifies the Amazon S3 key for the file location.

    • outputLocation (dict) -- [REQUIRED]

      Contains the Amazon S3 bucket and prefix for the location of the output file, which is contained in an S3Location object.

      • bucketName (string) --

        Specifies the name of the Amazon S3 bucket.

      • key (string) --

        Specifies the Amazon S3 key for the file location.

    • transformerId (string) -- [REQUIRED]

      Returns the system-assigned unique identifier for the transformer.

type instructionsDocuments:

list

param instructionsDocuments:

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.

  • (dict) --

    Specifies the details for the Amazon S3 file location that is being used with Amazon Web Services B2BI Data Interchange. File locations in Amazon S3 are identified using a combination of the bucket and key.

    • bucketName (string) --

      Specifies the name of the Amazon S3 bucket.

    • key (string) --

      Specifies the Amazon S3 key for the file location.

type clientToken:

string

param clientToken:

Reserved for future use.

This field is autopopulated if not provided.

type tags:

list

param tags:

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.

  • (dict) --

    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.

    • Key (string) -- [REQUIRED]

      Specifies the name assigned to the tag that you create.

    • Value (string) -- [REQUIRED]

      Contains one or more values that you assigned to the key name that you create.

rtype:

dict

returns:

Response Syntax

{
    'capabilityId': 'string',
    'capabilityArn': 'string',
    'name': 'string',
    'type': 'edi',
    'configuration': {
        'edi': {
            'type': {
                'x12Details': {
                    'transactionSet': 'X12_110'|'X12_180'|'X12_204'|'X12_210'|'X12_214'|'X12_215'|'X12_310'|'X12_315'|'X12_322'|'X12_404'|'X12_410'|'X12_820'|'X12_824'|'X12_830'|'X12_846'|'X12_850'|'X12_852'|'X12_855'|'X12_856'|'X12_860'|'X12_861'|'X12_864'|'X12_940'|'X12_990'|'X12_997',
                    'version': 'VERSION_4010'|'VERSION_4030'|'VERSION_5010'
                }
            },
            'inputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'outputLocation': {
                'bucketName': 'string',
                'key': 'string'
            },
            'transformerId': 'string'
        }
    },
    'instructionsDocuments': [
        {
            'bucketName': 'string',
            'key': 'string'
        },
    ],
    'createdAt': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • capabilityId (string) --

      Returns a system-assigned unique identifier for the capability.

    • capabilityArn (string) --

      Returns an Amazon Resource Name (ARN) for a specific Amazon Web Services resource, such as a capability, partnership, profile, or transformer.

    • name (string) --

      Returns the name of the capability used to identify it.

    • type (string) --

      Returns the type of the capability. Currently, only edi is supported.

    • configuration (dict) --

      Returns a structure that contains the details for a capability.

      • edi (dict) --

        An EDI (electronic data interchange) configuration object.

        • type (dict) --

          Returns the type of the capability. Currently, only edi is supported.

          • x12Details (dict) --

            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.

            • transactionSet (string) --

              Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.

            • version (string) --

              Returns the version to use for the specified X12 transaction set. Supported versions are 4010, 4030, and 5010.

        • inputLocation (dict) --

          Contains the Amazon S3 bucket and prefix for the location of the input file, which is contained in an S3Location object.

          • bucketName (string) --

            Specifies the name of the Amazon S3 bucket.

          • key (string) --

            Specifies the Amazon S3 key for the file location.

        • outputLocation (dict) --

          Contains the Amazon S3 bucket and prefix for the location of the output file, which is contained in an S3Location object.

          • bucketName (string) --

            Specifies the name of the Amazon S3 bucket.

          • key (string) --

            Specifies the Amazon S3 key for the file location.

        • transformerId (string) --

          Returns the system-assigned unique identifier for the transformer.

    • instructionsDocuments (list) --

      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.

      • (dict) --

        Specifies the details for the Amazon S3 file location that is being used with Amazon Web Services B2BI Data Interchange. File locations in Amazon S3 are identified using a combination of the bucket and key.

        • bucketName (string) --

          Specifies the name of the Amazon S3 bucket.

        • key (string) --

          Specifies the Amazon S3 key for the file location.

    • createdAt (datetime) --

      Returns a timestamp for creation date and time of the capability.

GetTransformerJob (new) Link ¶

Returns the details of the transformer run, based on the Transformer job ID.

See also: AWS API Documentation

Request Syntax

client.get_transformer_job(
    transformerJobId='string',
    transformerId='string'
)
type transformerJobId:

string

param transformerJobId:

[REQUIRED]

Specifies the unique, system-generated identifier for a transformer run.

type transformerId:

string

param transformerId:

[REQUIRED]

Specifies the system-assigned unique identifier for the transformer.

rtype:

dict

returns:

Response Syntax

{
    'status': 'running'|'succeeded'|'failed',
    'outputFiles': [
        {
            'bucketName': 'string',
            'key': 'string'
        },
    ],
    'message': 'string'
}

Response Structure

  • (dict) --

    • status (string) --

      Returns the current state of the transformer job, either running, succeeded, or failed.

    • outputFiles (list) --

      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.

      • (dict) --

        Specifies the details for the Amazon S3 file location that is being used with Amazon Web Services B2BI Data Interchange. File locations in Amazon S3 are identified using a combination of the bucket and key.

        • bucketName (string) --

          Specifies the name of the Amazon S3 bucket.

        • key (string) --

          Specifies the Amazon S3 key for the file location.

    • message (string) --

      Returns an optional error message, which gets populated when the job is not run successfully.