We announced the upcoming end-of-support for AWS SDK for JavaScript v2.
We recommend that you migrate to AWS SDK for JavaScript v3. For dates, additional details, and information on how to migrate, please refer to the linked announcement.

Class: AWS.B2bi

Inherits:
AWS.Service show all
Identifier:
b2bi
API Version:
2022-06-23
Defined in:
(unknown)

Overview

Constructs a service interface object. Each API operation is exposed as a function on service.

Service Description

This is the Amazon Web Services B2B Data Interchange API Reference. It provides descriptions, API request parameters, and the XML response for each of the B2BI API actions.

B2BI enables automated exchange of EDI (electronic data interchange) based business-critical transactions at cloud scale, with elasticity and pay-as-you-go pricing. Businesses use EDI documents to exchange transactional data with trading partners, such as suppliers and end customers, using standardized formats such as X12.

Note: Rather than actually running a command, you can use the --generate-cli-skeleton parameter with any API call to generate and display a parameter template. You can then use the generated template to customize and use as input on a later command. For details, see Generate and use a parameter skeleton file.

Sending a Request Using B2bi

var b2bi = new AWS.B2bi();
b2bi.createCapability(params, function (err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Locking the API Version

In order to ensure that the B2bi object uses this specific API, you can construct the object by passing the apiVersion option to the constructor:

var b2bi = new AWS.B2bi({apiVersion: '2022-06-23'});

You can also set the API version globally in AWS.config.apiVersions using the b2bi service identifier:

AWS.config.apiVersions = {
  b2bi: '2022-06-23',
  // other service API versions
};

var b2bi = new AWS.B2bi();

Version:

  • 2022-06-23

Constructor Summary collapse

Property Summary collapse

Properties inherited from AWS.Service

apiVersions

Method Summary collapse

Methods inherited from AWS.Service

makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService

Constructor Details

new AWS.B2bi(options = {}) ⇒ Object

Constructs a service object. This object has one method for each API operation.

Examples:

Constructing a B2bi object

var b2bi = new AWS.B2bi({apiVersion: '2022-06-23'});

Options Hash (options):

  • params (map)

    An optional map of parameters to bind to every request sent by this service object. For more information on bound parameters, see "Working with Services" in the Getting Started Guide.

  • endpoint (String|AWS.Endpoint)

    The endpoint URI to send requests to. The default endpoint is built from the configured region. The endpoint should be a string like 'https://{service}.{region}.amazonaws.com' or an Endpoint object.

  • accessKeyId (String)

    your AWS access key ID.

  • secretAccessKey (String)

    your AWS secret access key.

  • sessionToken (AWS.Credentials)

    the optional AWS session token to sign requests with.

  • credentials (AWS.Credentials)

    the AWS credentials to sign requests with. You can either specify this object, or specify the accessKeyId and secretAccessKey options directly.

  • credentialProvider (AWS.CredentialProviderChain)

    the provider chain used to resolve credentials if no static credentials property is set.

  • region (String)

    the region to send service requests to. See AWS.B2bi.region for more information.

  • maxRetries (Integer)

    the maximum amount of retries to attempt with a request. See AWS.B2bi.maxRetries for more information.

  • maxRedirects (Integer)

    the maximum amount of redirects to follow with a request. See AWS.B2bi.maxRedirects for more information.

  • sslEnabled (Boolean)

    whether to enable SSL for requests.

  • paramValidation (Boolean|map)

    whether input parameters should be validated against the operation description before sending the request. Defaults to true. Pass a map to enable any of the following specific validation features:

    • min [Boolean] — Validates that a value meets the min constraint. This is enabled by default when paramValidation is set to true.
    • max [Boolean] — Validates that a value meets the max constraint.
    • pattern [Boolean] — Validates that a string value matches a regular expression.
    • enum [Boolean] — Validates that a string value matches one of the allowable enum values.
  • computeChecksums (Boolean)

    whether to compute checksums for payload bodies when the service accepts it (currently supported in S3 only)

  • convertResponseTypes (Boolean)

    whether types are converted when parsing response data. Currently only supported for JSON based services. Turning this off may improve performance on large response payloads. Defaults to true.

  • correctClockSkew (Boolean)

    whether to apply a clock skew correction and retry requests that fail because of an skewed client clock. Defaults to false.

  • s3ForcePathStyle (Boolean)

    whether to force path style URLs for S3 objects.

  • s3BucketEndpoint (Boolean)

    whether the provided endpoint addresses an individual bucket (false if it addresses the root API endpoint). Note that setting this configuration option requires an endpoint to be provided explicitly to the service constructor.

  • s3DisableBodySigning (Boolean)

    whether S3 body signing should be disabled when using signature version v4. Body signing can only be disabled when using https. Defaults to true.

  • s3UsEast1RegionalEndpoint ('legacy'|'regional')

    when region is set to 'us-east-1', whether to send s3 request to global endpoints or 'us-east-1' regional endpoints. This config is only applicable to S3 client. Defaults to legacy

  • s3UseArnRegion (Boolean)

    whether to override the request region with the region inferred from requested resource's ARN. Only available for S3 buckets Defaults to true

  • retryDelayOptions (map)

    A set of options to configure the retry delay on retryable errors. Currently supported options are:

    • base [Integer] — The base number of milliseconds to use in the exponential backoff for operation retries. Defaults to 100 ms for all services except DynamoDB, where it defaults to 50ms.
    • customBackoff [function] — A custom function that accepts a retry count and error and returns the amount of time to delay in milliseconds. If the result is a non-zero negative value, no further retry attempts will be made. The base option will be ignored if this option is supplied. The function is only called for retryable errors.
  • httpOptions (map)

    A set of options to pass to the low-level HTTP request. Currently supported options are:

    • proxy [String] — the URL to proxy requests through
    • agent [http.Agent, https.Agent] — the Agent object to perform HTTP requests with. Used for connection pooling. Defaults to the global agent (http.globalAgent) for non-SSL connections. Note that for SSL connections, a special Agent object is used in order to enable peer certificate verification. This feature is only available in the Node.js environment.
    • connectTimeout [Integer] — Sets the socket to timeout after failing to establish a connection with the server after connectTimeout milliseconds. This timeout has no effect once a socket connection has been established.
    • timeout [Integer] — Sets the socket to timeout after timeout milliseconds of inactivity on the socket. Defaults to two minutes (120000).
    • xhrAsync [Boolean] — Whether the SDK will send asynchronous HTTP requests. Used in the browser environment only. Set to false to send requests synchronously. Defaults to true (async on).
    • xhrWithCredentials [Boolean] — Sets the "withCredentials" property of an XMLHttpRequest object. Used in the browser environment only. Defaults to false.
  • apiVersion (String, Date)

    a String in YYYY-MM-DD format (or a date) that represents the latest possible API version that can be used in all services (unless overridden by apiVersions). Specify 'latest' to use the latest possible version.

  • apiVersions (map<String, String|Date>)

    a map of service identifiers (the lowercase service class name) with the API version to use when instantiating a service. Specify 'latest' for each individual that can use the latest available version.

  • logger (#write, #log)

    an object that responds to .write() (like a stream) or .log() (like the console object) in order to log information about requests

  • systemClockOffset (Number)

    an offset value in milliseconds to apply to all signing times. Use this to compensate for clock skew when your system may be out of sync with the service time. Note that this configuration option can only be applied to the global AWS.config object and cannot be overridden in service-specific configuration. Defaults to 0 milliseconds.

  • signatureVersion (String)

    the signature version to sign requests with (overriding the API configuration). Possible values are: 'v2', 'v3', 'v4'.

  • signatureCache (Boolean)

    whether the signature to sign requests with (overriding the API configuration) is cached. Only applies to the signature version 'v4'. Defaults to true.

  • dynamoDbCrc32 (Boolean)

    whether to validate the CRC32 checksum of HTTP response bodies returned by DynamoDB. Default: true.

  • useAccelerateEndpoint (Boolean)

    Whether to use the S3 Transfer Acceleration endpoint with the S3 service. Default: false.

  • clientSideMonitoring (Boolean)

    whether to collect and publish this client's performance metrics of all its API requests.

  • endpointDiscoveryEnabled (Boolean|undefined)

    whether to call operations with endpoints given by service dynamically. Setting this

  • endpointCacheSize (Number)

    the size of the global cache storing endpoints from endpoint discovery operations. Once endpoint cache is created, updating this setting cannot change existing cache size. Defaults to 1000

  • hostPrefixEnabled (Boolean)

    whether to marshal request parameters to the prefix of hostname. Defaults to true.

  • stsRegionalEndpoints ('legacy'|'regional')

    whether to send sts request to global endpoints or regional endpoints. Defaults to 'legacy'.

  • useFipsEndpoint (Boolean)

    Enables FIPS compatible endpoints. Defaults to false.

  • useDualstackEndpoint (Boolean)

    Enables IPv6 dualstack endpoint. Defaults to false.

Property Details

endpointAWS.Endpoint (readwrite)

Returns an Endpoint object representing the endpoint URL for service requests.

Returns:

  • (AWS.Endpoint)

    an Endpoint object representing the endpoint URL for service requests.

Method Details

createCapability(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the createCapability operation

var params = {
  configuration: { /* required */
    edi: {
      inputLocation: { /* required */
        bucketName: 'STRING_VALUE',
        key: 'STRING_VALUE'
      },
      outputLocation: { /* required */
        bucketName: 'STRING_VALUE',
        key: 'STRING_VALUE'
      },
      transformerId: 'STRING_VALUE', /* required */
      type: { /* required */
        x12Details: {
          transactionSet: X12_110 | X12_180 | X12_204 | X12_210 | X12_211 | X12_214 | X12_215 | X12_259 | X12_260 | X12_266 | X12_269 | X12_270 | X12_271 | X12_274 | X12_275 | X12_276 | X12_277 | X12_278 | X12_310 | X12_315 | X12_322 | X12_404 | X12_410 | X12_417 | X12_421 | X12_426 | X12_810 | X12_820 | X12_824 | X12_830 | X12_832 | X12_834 | X12_835 | X12_837 | X12_844 | X12_846 | X12_849 | X12_850 | X12_852 | X12_855 | X12_856 | X12_860 | X12_861 | X12_864 | X12_865 | X12_869 | X12_870 | X12_940 | X12_945 | X12_990 | X12_997 | 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_5010 | VERSION_5010_HIPAA
        }
      }
    }
  },
  name: 'STRING_VALUE', /* required */
  type: edi, /* required */
  clientToken: 'STRING_VALUE',
  instructionsDocuments: [
    {
      bucketName: 'STRING_VALUE',
      key: 'STRING_VALUE'
    },
    /* more items */
  ],
  tags: [
    {
      Key: 'STRING_VALUE', /* required */
      Value: 'STRING_VALUE' /* required */
    },
    /* more items */
  ]
};
b2bi.createCapability(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

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

    • type — (String)

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

      Possible values include:
      • "edi"
    • configuration — (map)

      Specifies a structure that contains the details for a capability.

      • edi — (map)

        An EDI (electronic data interchange) configuration object.

        • typerequired — (map)

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

          • x12Details — (map)

            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.

              Possible values include:
              • "X12_110"
              • "X12_180"
              • "X12_204"
              • "X12_210"
              • "X12_211"
              • "X12_214"
              • "X12_215"
              • "X12_259"
              • "X12_260"
              • "X12_266"
              • "X12_269"
              • "X12_270"
              • "X12_271"
              • "X12_274"
              • "X12_275"
              • "X12_276"
              • "X12_277"
              • "X12_278"
              • "X12_310"
              • "X12_315"
              • "X12_322"
              • "X12_404"
              • "X12_410"
              • "X12_417"
              • "X12_421"
              • "X12_426"
              • "X12_810"
              • "X12_820"
              • "X12_824"
              • "X12_830"
              • "X12_832"
              • "X12_834"
              • "X12_835"
              • "X12_837"
              • "X12_844"
              • "X12_846"
              • "X12_849"
              • "X12_850"
              • "X12_852"
              • "X12_855"
              • "X12_856"
              • "X12_860"
              • "X12_861"
              • "X12_864"
              • "X12_865"
              • "X12_869"
              • "X12_870"
              • "X12_940"
              • "X12_945"
              • "X12_990"
              • "X12_997"
              • "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 — (String)

              Returns the version to use for the specified X12 transaction set.

               </p> 
              Possible values include:
              • "VERSION_4010"
              • "VERSION_4030"
              • "VERSION_5010"
              • "VERSION_5010_HIPAA"
        • inputLocationrequired — (map)

          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.

        • outputLocationrequired — (map)

          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.

        • transformerIdrequired — (String)

          Returns the system-assigned unique identifier for the transformer.

    • instructionsDocuments — (Array<map>)

      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.

      • bucketName — (String)

        Specifies the name of the Amazon S3 bucket.

      • key — (String)

        Specifies the Amazon S3 key for the file location.

    • clientToken — (String)

      Reserved for future use.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (Array<map>)

      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.

      • Keyrequired — (String)

        Specifies the name assigned to the tag that you create.

      • Valuerequired — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "edi"
      • configuration — (map)

        Returns a structure that contains the details for a capability.

        • edi — (map)

          An EDI (electronic data interchange) configuration object.

          • typerequired — (map)

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

            • x12Details — (map)

              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.

                Possible values include:
                • "X12_110"
                • "X12_180"
                • "X12_204"
                • "X12_210"
                • "X12_211"
                • "X12_214"
                • "X12_215"
                • "X12_259"
                • "X12_260"
                • "X12_266"
                • "X12_269"
                • "X12_270"
                • "X12_271"
                • "X12_274"
                • "X12_275"
                • "X12_276"
                • "X12_277"
                • "X12_278"
                • "X12_310"
                • "X12_315"
                • "X12_322"
                • "X12_404"
                • "X12_410"
                • "X12_417"
                • "X12_421"
                • "X12_426"
                • "X12_810"
                • "X12_820"
                • "X12_824"
                • "X12_830"
                • "X12_832"
                • "X12_834"
                • "X12_835"
                • "X12_837"
                • "X12_844"
                • "X12_846"
                • "X12_849"
                • "X12_850"
                • "X12_852"
                • "X12_855"
                • "X12_856"
                • "X12_860"
                • "X12_861"
                • "X12_864"
                • "X12_865"
                • "X12_869"
                • "X12_870"
                • "X12_940"
                • "X12_945"
                • "X12_990"
                • "X12_997"
                • "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 — (String)

                Returns the version to use for the specified X12 transaction set.

                 </p> 
                Possible values include:
                • "VERSION_4010"
                • "VERSION_4030"
                • "VERSION_5010"
                • "VERSION_5010_HIPAA"
          • inputLocationrequired — (map)

            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.

          • outputLocationrequired — (map)

            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.

          • transformerIdrequired — (String)

            Returns the system-assigned unique identifier for the transformer.

      • instructionsDocuments — (Array<map>)

        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.

        • bucketName — (String)

          Specifies the name of the Amazon S3 bucket.

        • key — (String)

          Specifies the Amazon S3 key for the file location.

      • createdAt — (Date)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createPartnership(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the createPartnership operation

var params = {
  capabilities: [ /* required */
    'STRING_VALUE',
    /* more items */
  ],
  email: 'STRING_VALUE', /* required */
  name: 'STRING_VALUE', /* required */
  profileId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  phone: 'STRING_VALUE',
  tags: [
    {
      Key: 'STRING_VALUE', /* required */
      Value: 'STRING_VALUE' /* required */
    },
    /* more items */
  ]
};
b2bi.createPartnership(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • profileId — (String)

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

    • name — (String)

      Specifies a descriptive name for the partnership.

    • email — (String)

      Specifies the email address associated with this trading partner.

    • phone — (String)

      Specifies the phone number associated with the partnership.

    • capabilities — (Array<String>)

      Specifies a list of the capabilities associated with this partnership.

    • clientToken — (String)

      Reserved for future use.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (Array<map>)

      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.

      • Keyrequired — (String)

        Specifies the name assigned to the tag that you create.

      • Valuerequired — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • 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 — (Array<String>)

        Returns one or more capabilities associated with this partnership.

      • tradingPartnerId — (String)

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

      • createdAt — (Date)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createProfile(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the createProfile operation

var params = {
  businessName: 'STRING_VALUE', /* required */
  logging: ENABLED | DISABLED, /* required */
  name: 'STRING_VALUE', /* required */
  phone: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  email: 'STRING_VALUE',
  tags: [
    {
      Key: 'STRING_VALUE', /* required */
      Value: 'STRING_VALUE' /* required */
    },
    /* more items */
  ]
};
b2bi.createProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

      Specifies the name of the profile.

    • email — (String)

      Specifies the email address associated with this customer profile.

    • phone — (String)

      Specifies the phone number associated with the profile.

    • businessName — (String)

      Specifies the name for the business associated with this profile.

    • logging — (String)

      Specifies whether or not logging is enabled for this profile.

      Possible values include:
      • "ENABLED"
      • "DISABLED"
    • clientToken — (String)

      Reserved for future use.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (Array<map>)

      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.

      • Keyrequired — (String)

        Specifies the name assigned to the tag that you create.

      • Valuerequired — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "ENABLED"
        • "DISABLED"
      • logGroupName — (String)

        Returns the name of the logging group.

      • createdAt — (Date)

        Returns a timestamp representing the time the profile was created.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

createTransformer(params = {}, callback) ⇒ AWS.Request

Creates a transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.

Service Reference:

Examples:

Calling the createTransformer operation

var params = {
  ediType: { /* required */
    x12Details: {
      transactionSet: X12_110 | X12_180 | X12_204 | X12_210 | X12_211 | X12_214 | X12_215 | X12_259 | X12_260 | X12_266 | X12_269 | X12_270 | X12_271 | X12_274 | X12_275 | X12_276 | X12_277 | X12_278 | X12_310 | X12_315 | X12_322 | X12_404 | X12_410 | X12_417 | X12_421 | X12_426 | X12_810 | X12_820 | X12_824 | X12_830 | X12_832 | X12_834 | X12_835 | X12_837 | X12_844 | X12_846 | X12_849 | X12_850 | X12_852 | X12_855 | X12_856 | X12_860 | X12_861 | X12_864 | X12_865 | X12_869 | X12_870 | X12_940 | X12_945 | X12_990 | X12_997 | 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_5010 | VERSION_5010_HIPAA
    }
  },
  fileFormat: XML | JSON, /* required */
  mappingTemplate: 'STRING_VALUE', /* required */
  name: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  sampleDocument: 'STRING_VALUE',
  tags: [
    {
      Key: 'STRING_VALUE', /* required */
      Value: 'STRING_VALUE' /* required */
    },
    /* more items */
  ]
};
b2bi.createTransformer(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • name — (String)

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

    • fileFormat — (String)

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

      Possible values include:
      • "XML"
      • "JSON"
    • mappingTemplate — (String)

      Specifies the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.

    • ediType — (map)

      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 — (map)

        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.

          Possible values include:
          • "X12_110"
          • "X12_180"
          • "X12_204"
          • "X12_210"
          • "X12_211"
          • "X12_214"
          • "X12_215"
          • "X12_259"
          • "X12_260"
          • "X12_266"
          • "X12_269"
          • "X12_270"
          • "X12_271"
          • "X12_274"
          • "X12_275"
          • "X12_276"
          • "X12_277"
          • "X12_278"
          • "X12_310"
          • "X12_315"
          • "X12_322"
          • "X12_404"
          • "X12_410"
          • "X12_417"
          • "X12_421"
          • "X12_426"
          • "X12_810"
          • "X12_820"
          • "X12_824"
          • "X12_830"
          • "X12_832"
          • "X12_834"
          • "X12_835"
          • "X12_837"
          • "X12_844"
          • "X12_846"
          • "X12_849"
          • "X12_850"
          • "X12_852"
          • "X12_855"
          • "X12_856"
          • "X12_860"
          • "X12_861"
          • "X12_864"
          • "X12_865"
          • "X12_869"
          • "X12_870"
          • "X12_940"
          • "X12_945"
          • "X12_990"
          • "X12_997"
          • "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 — (String)

          Returns the version to use for the specified X12 transaction set.

           </p> 
          Possible values include:
          • "VERSION_4010"
          • "VERSION_4030"
          • "VERSION_5010"
          • "VERSION_5010_HIPAA"
    • sampleDocument — (String)

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

    • clientToken — (String)

      Reserved for future use.

      If a token is not provided, the SDK will use a version 4 UUID.
    • tags — (Array<map>)

      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.

      • Keyrequired — (String)

        Specifies the name assigned to the tag that you create.

      • Valuerequired — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "XML"
        • "JSON"
      • mappingTemplate — (String)

        Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.

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

        Possible values include:
        • "active"
        • "inactive"
      • ediType — (map)

        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 — (map)

          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.

            Possible values include:
            • "X12_110"
            • "X12_180"
            • "X12_204"
            • "X12_210"
            • "X12_211"
            • "X12_214"
            • "X12_215"
            • "X12_259"
            • "X12_260"
            • "X12_266"
            • "X12_269"
            • "X12_270"
            • "X12_271"
            • "X12_274"
            • "X12_275"
            • "X12_276"
            • "X12_277"
            • "X12_278"
            • "X12_310"
            • "X12_315"
            • "X12_322"
            • "X12_404"
            • "X12_410"
            • "X12_417"
            • "X12_421"
            • "X12_426"
            • "X12_810"
            • "X12_820"
            • "X12_824"
            • "X12_830"
            • "X12_832"
            • "X12_834"
            • "X12_835"
            • "X12_837"
            • "X12_844"
            • "X12_846"
            • "X12_849"
            • "X12_850"
            • "X12_852"
            • "X12_855"
            • "X12_856"
            • "X12_860"
            • "X12_861"
            • "X12_864"
            • "X12_865"
            • "X12_869"
            • "X12_870"
            • "X12_940"
            • "X12_945"
            • "X12_990"
            • "X12_997"
            • "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 — (String)

            Returns the version to use for the specified X12 transaction set.

             </p> 
            Possible values include:
            • "VERSION_4010"
            • "VERSION_4030"
            • "VERSION_5010"
            • "VERSION_5010_HIPAA"
      • sampleDocument — (String)

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

      • createdAt — (Date)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteCapability(params = {}, callback) ⇒ AWS.Request

Deletes the specified capability. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.

Service Reference:

Examples:

Calling the deleteCapability operation

var params = {
  capabilityId: 'STRING_VALUE' /* required */
};
b2bi.deleteCapability(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • capabilityId — (String)

      Specifies a system-assigned unique identifier for the capability.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deletePartnership(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the deletePartnership operation

var params = {
  partnershipId: 'STRING_VALUE' /* required */
};
b2bi.deletePartnership(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • partnershipId — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteProfile(params = {}, callback) ⇒ AWS.Request

Deletes the specified profile. A profile is the mechanism used to create the concept of a private network.

Service Reference:

Examples:

Calling the deleteProfile operation

var params = {
  profileId: 'STRING_VALUE' /* required */
};
b2bi.deleteProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • profileId — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

deleteTransformer(params = {}, callback) ⇒ AWS.Request

Deletes the specified transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.

Service Reference:

Examples:

Calling the deleteTransformer operation

var params = {
  transformerId: 'STRING_VALUE' /* required */
};
b2bi.deleteTransformer(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • transformerId — (String)

      Specifies the system-assigned unique identifier for the transformer.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getCapability(params = {}, callback) ⇒ AWS.Request

Retrieves the details for the specified capability. A trading capability contains the information required to transform incoming EDI documents into JSON or XML outputs.

Service Reference:

Examples:

Calling the getCapability operation

var params = {
  capabilityId: 'STRING_VALUE' /* required */
};
b2bi.getCapability(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • capabilityId — (String)

      Specifies a system-assigned unique identifier for the capability.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "edi"
      • configuration — (map)

        Returns a structure that contains the details for a capability.

        • edi — (map)

          An EDI (electronic data interchange) configuration object.

          • typerequired — (map)

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

            • x12Details — (map)

              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.

                Possible values include:
                • "X12_110"
                • "X12_180"
                • "X12_204"
                • "X12_210"
                • "X12_211"
                • "X12_214"
                • "X12_215"
                • "X12_259"
                • "X12_260"
                • "X12_266"
                • "X12_269"
                • "X12_270"
                • "X12_271"
                • "X12_274"
                • "X12_275"
                • "X12_276"
                • "X12_277"
                • "X12_278"
                • "X12_310"
                • "X12_315"
                • "X12_322"
                • "X12_404"
                • "X12_410"
                • "X12_417"
                • "X12_421"
                • "X12_426"
                • "X12_810"
                • "X12_820"
                • "X12_824"
                • "X12_830"
                • "X12_832"
                • "X12_834"
                • "X12_835"
                • "X12_837"
                • "X12_844"
                • "X12_846"
                • "X12_849"
                • "X12_850"
                • "X12_852"
                • "X12_855"
                • "X12_856"
                • "X12_860"
                • "X12_861"
                • "X12_864"
                • "X12_865"
                • "X12_869"
                • "X12_870"
                • "X12_940"
                • "X12_945"
                • "X12_990"
                • "X12_997"
                • "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 — (String)

                Returns the version to use for the specified X12 transaction set.

                 </p> 
                Possible values include:
                • "VERSION_4010"
                • "VERSION_4030"
                • "VERSION_5010"
                • "VERSION_5010_HIPAA"
          • inputLocationrequired — (map)

            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.

          • outputLocationrequired — (map)

            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.

          • transformerIdrequired — (String)

            Returns the system-assigned unique identifier for the transformer.

      • instructionsDocuments — (Array<map>)

        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.

        • bucketName — (String)

          Specifies the name of the Amazon S3 bucket.

        • key — (String)

          Specifies the Amazon S3 key for the file location.

      • createdAt — (Date)

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

      • modifiedAt — (Date)

        Returns a timestamp for last time the capability was modified.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getPartnership(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the getPartnership operation

var params = {
  partnershipId: 'STRING_VALUE' /* required */
};
b2bi.getPartnership(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • partnershipId — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • 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 — (Array<String>)

        Returns one or more capabilities associated with this partnership.

      • tradingPartnerId — (String)

        Returns the unique identifier for the partner for this partnership.

      • createdAt — (Date)

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

      • modifiedAt — (Date)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getProfile(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the getProfile operation

var params = {
  profileId: 'STRING_VALUE' /* required */
};
b2bi.getProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • profileId — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "ENABLED"
        • "DISABLED"
      • logGroupName — (String)

        Returns the name of the logging group.

      • createdAt — (Date)

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

      • modifiedAt — (Date)

        Returns a timestamp for last time the profile was modified.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTransformer(params = {}, callback) ⇒ AWS.Request

Retrieves the details for the transformer specified by the transformer ID. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.

Service Reference:

Examples:

Calling the getTransformer operation

var params = {
  transformerId: 'STRING_VALUE' /* required */
};
b2bi.getTransformer(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • transformerId — (String)

      Specifies the system-assigned unique identifier for the transformer.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "XML"
        • "JSON"
      • mappingTemplate — (String)

        Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.

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

        Possible values include:
        • "active"
        • "inactive"
      • ediType — (map)

        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 — (map)

          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.

            Possible values include:
            • "X12_110"
            • "X12_180"
            • "X12_204"
            • "X12_210"
            • "X12_211"
            • "X12_214"
            • "X12_215"
            • "X12_259"
            • "X12_260"
            • "X12_266"
            • "X12_269"
            • "X12_270"
            • "X12_271"
            • "X12_274"
            • "X12_275"
            • "X12_276"
            • "X12_277"
            • "X12_278"
            • "X12_310"
            • "X12_315"
            • "X12_322"
            • "X12_404"
            • "X12_410"
            • "X12_417"
            • "X12_421"
            • "X12_426"
            • "X12_810"
            • "X12_820"
            • "X12_824"
            • "X12_830"
            • "X12_832"
            • "X12_834"
            • "X12_835"
            • "X12_837"
            • "X12_844"
            • "X12_846"
            • "X12_849"
            • "X12_850"
            • "X12_852"
            • "X12_855"
            • "X12_856"
            • "X12_860"
            • "X12_861"
            • "X12_864"
            • "X12_865"
            • "X12_869"
            • "X12_870"
            • "X12_940"
            • "X12_945"
            • "X12_990"
            • "X12_997"
            • "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 — (String)

            Returns the version to use for the specified X12 transaction set.

             </p> 
            Possible values include:
            • "VERSION_4010"
            • "VERSION_4030"
            • "VERSION_5010"
            • "VERSION_5010_HIPAA"
      • sampleDocument — (String)

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

      • createdAt — (Date)

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

      • modifiedAt — (Date)

        Returns a timestamp for last time the transformer was modified.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

getTransformerJob(params = {}, callback) ⇒ AWS.Request

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

Service Reference:

Examples:

Calling the getTransformerJob operation

var params = {
  transformerId: 'STRING_VALUE', /* required */
  transformerJobId: 'STRING_VALUE' /* required */
};
b2bi.getTransformerJob(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • transformerJobId — (String)

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

    • transformerId — (String)

      Specifies the system-assigned unique identifier for the transformer.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • status — (String)

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

        Possible values include:
        • "running"
        • "succeeded"
        • "failed"
      • outputFiles — (Array<map>)

        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.

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listCapabilities(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the listCapabilities operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
b2bi.listCapabilities(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • 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.

    • maxResults — (Integer)

      Specifies the maximum number of capabilities to return.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • capabilities — (Array<map>)

        Returns one or more capabilities associated with this partnership.

        • capabilityIdrequired — (String)

          Returns a system-assigned unique identifier for the capability.

        • namerequired — (String)

          The display name of the capability.

        • typerequired — (String)

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

          Possible values include:
          • "edi"
        • createdAtrequired — (Date)

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

        • modifiedAt — (Date)

          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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listPartnerships(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the listPartnerships operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  profileId: 'STRING_VALUE'
};
b2bi.listPartnerships(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • profileId — (String)

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

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

    • maxResults — (Integer)

      Specifies the maximum number of capabilities to return.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • partnerships — (Array<map>)

        Specifies a list of your partnerships.

        • profileIdrequired — (String)

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

        • partnershipIdrequired — (String)

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

        • name — (String)

          Returns the name of the partnership.

        • capabilities — (Array<String>)

          Returns one or more capabilities associated with this partnership.

        • tradingPartnerId — (String)

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

        • createdAtrequired — (Date)

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

        • modifiedAt — (Date)

          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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listProfiles(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the listProfiles operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
b2bi.listProfiles(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • 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.

    • maxResults — (Integer)

      Specifies the maximum number of profiles to return.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • profiles — (Array<map>)

        Returns an array of ProfileSummary objects.

        • profileIdrequired — (String)

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

        • namerequired — (String)

          Returns the display name for profile.

        • businessNamerequired — (String)

          Returns the name for the business associated with this profile.

        • logging — (String)

          Specifies whether or not logging is enabled for this profile.

          Possible values include:
          • "ENABLED"
          • "DISABLED"
        • logGroupName — (String)

          Returns the name of the logging group.

        • createdAtrequired — (Date)

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

        • modifiedAt — (Date)

          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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTagsForResource(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the listTagsForResource operation

var params = {
  ResourceARN: 'STRING_VALUE' /* required */
};
b2bi.listTagsForResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • ResourceARN — (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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • Tags — (Array<map>)

        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.

        • Keyrequired — (String)

          Specifies the name assigned to the tag that you create.

        • Valuerequired — (String)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

listTransformers(params = {}, callback) ⇒ AWS.Request

Lists the available transformers. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.

Service Reference:

Examples:

Calling the listTransformers operation

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
b2bi.listTransformers(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • 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.

    • maxResults — (Integer)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • transformers — (Array<map>)

        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.

        • transformerIdrequired — (String)

          Returns the system-assigned unique identifier for the transformer.

        • namerequired — (String)

          Returns the descriptive name for the transformer.

        • fileFormatrequired — (String)

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

          Possible values include:
          • "XML"
          • "JSON"
        • mappingTemplaterequired — (String)

          Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.

        • statusrequired — (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.

          Possible values include:
          • "active"
          • "inactive"
        • ediTyperequired — (map)

          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 — (map)

            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.

              Possible values include:
              • "X12_110"
              • "X12_180"
              • "X12_204"
              • "X12_210"
              • "X12_211"
              • "X12_214"
              • "X12_215"
              • "X12_259"
              • "X12_260"
              • "X12_266"
              • "X12_269"
              • "X12_270"
              • "X12_271"
              • "X12_274"
              • "X12_275"
              • "X12_276"
              • "X12_277"
              • "X12_278"
              • "X12_310"
              • "X12_315"
              • "X12_322"
              • "X12_404"
              • "X12_410"
              • "X12_417"
              • "X12_421"
              • "X12_426"
              • "X12_810"
              • "X12_820"
              • "X12_824"
              • "X12_830"
              • "X12_832"
              • "X12_834"
              • "X12_835"
              • "X12_837"
              • "X12_844"
              • "X12_846"
              • "X12_849"
              • "X12_850"
              • "X12_852"
              • "X12_855"
              • "X12_856"
              • "X12_860"
              • "X12_861"
              • "X12_864"
              • "X12_865"
              • "X12_869"
              • "X12_870"
              • "X12_940"
              • "X12_945"
              • "X12_990"
              • "X12_997"
              • "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 — (String)

              Returns the version to use for the specified X12 transaction set.

               </p> 
              Possible values include:
              • "VERSION_4010"
              • "VERSION_4030"
              • "VERSION_5010"
              • "VERSION_5010_HIPAA"
        • sampleDocument — (String)

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

        • createdAtrequired — (Date)

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

        • modifiedAt — (Date)

          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.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

startTransformerJob(params = {}, callback) ⇒ AWS.Request

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.

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.

Service Reference:

Examples:

Calling the startTransformerJob operation

var params = {
  inputFile: { /* required */
    bucketName: 'STRING_VALUE',
    key: 'STRING_VALUE'
  },
  outputLocation: { /* required */
    bucketName: 'STRING_VALUE',
    key: 'STRING_VALUE'
  },
  transformerId: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE'
};
b2bi.startTransformerJob(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • inputFile — (map)

      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.

    • outputLocation — (map)

      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.

    • transformerId — (String)

      Specifies the system-assigned unique identifier for the transformer.

    • clientToken — (String)

      Reserved for future use.

      If a token is not provided, the SDK will use a version 4 UUID.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • transformerJobId — (String)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

tagResource(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the tagResource operation

var params = {
  ResourceARN: 'STRING_VALUE', /* required */
  Tags: [ /* required */
    {
      Key: 'STRING_VALUE', /* required */
      Value: 'STRING_VALUE' /* required */
    },
    /* more items */
  ]
};
b2bi.tagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • ResourceARN — (String)

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

    • Tags — (Array<map>)

      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.

      • Keyrequired — (String)

        Specifies the name assigned to the tag that you create.

      • Valuerequired — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

testMapping(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the testMapping operation

var params = {
  fileFormat: XML | JSON, /* required */
  inputFileContent: 'STRING_VALUE', /* required */
  mappingTemplate: 'STRING_VALUE' /* required */
};
b2bi.testMapping(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • inputFileContent — (String)

      Specify the contents of the EDI (electronic data interchange) XML or JSON file that is used as input for the transform.

    • mappingTemplate — (String)

      Specifies the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.

    • fileFormat — (String)

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

      Possible values include:
      • "XML"
      • "JSON"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • mappedFileContent — (String)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

testParsing(params = {}, callback) ⇒ AWS.Request

Parses the input EDI (electronic data interchange) file. The input file has a file size limit of 250 KB.

Service Reference:

Examples:

Calling the testParsing operation

var params = {
  ediType: { /* required */
    x12Details: {
      transactionSet: X12_110 | X12_180 | X12_204 | X12_210 | X12_211 | X12_214 | X12_215 | X12_259 | X12_260 | X12_266 | X12_269 | X12_270 | X12_271 | X12_274 | X12_275 | X12_276 | X12_277 | X12_278 | X12_310 | X12_315 | X12_322 | X12_404 | X12_410 | X12_417 | X12_421 | X12_426 | X12_810 | X12_820 | X12_824 | X12_830 | X12_832 | X12_834 | X12_835 | X12_837 | X12_844 | X12_846 | X12_849 | X12_850 | X12_852 | X12_855 | X12_856 | X12_860 | X12_861 | X12_864 | X12_865 | X12_869 | X12_870 | X12_940 | X12_945 | X12_990 | X12_997 | 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_5010 | VERSION_5010_HIPAA
    }
  },
  fileFormat: XML | JSON, /* required */
  inputFile: { /* required */
    bucketName: 'STRING_VALUE',
    key: 'STRING_VALUE'
  }
};
b2bi.testParsing(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • inputFile — (map)

      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.

    • fileFormat — (String)

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

      Possible values include:
      • "XML"
      • "JSON"
    • ediType — (map)

      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 — (map)

        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.

          Possible values include:
          • "X12_110"
          • "X12_180"
          • "X12_204"
          • "X12_210"
          • "X12_211"
          • "X12_214"
          • "X12_215"
          • "X12_259"
          • "X12_260"
          • "X12_266"
          • "X12_269"
          • "X12_270"
          • "X12_271"
          • "X12_274"
          • "X12_275"
          • "X12_276"
          • "X12_277"
          • "X12_278"
          • "X12_310"
          • "X12_315"
          • "X12_322"
          • "X12_404"
          • "X12_410"
          • "X12_417"
          • "X12_421"
          • "X12_426"
          • "X12_810"
          • "X12_820"
          • "X12_824"
          • "X12_830"
          • "X12_832"
          • "X12_834"
          • "X12_835"
          • "X12_837"
          • "X12_844"
          • "X12_846"
          • "X12_849"
          • "X12_850"
          • "X12_852"
          • "X12_855"
          • "X12_856"
          • "X12_860"
          • "X12_861"
          • "X12_864"
          • "X12_865"
          • "X12_869"
          • "X12_870"
          • "X12_940"
          • "X12_945"
          • "X12_990"
          • "X12_997"
          • "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 — (String)

          Returns the version to use for the specified X12 transaction set.

           </p> 
          Possible values include:
          • "VERSION_4010"
          • "VERSION_4030"
          • "VERSION_5010"
          • "VERSION_5010_HIPAA"

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • parsedFileContent — (String)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

untagResource(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the untagResource operation

var params = {
  ResourceARN: 'STRING_VALUE', /* required */
  TagKeys: [ /* required */
    'STRING_VALUE',
    /* more items */
  ]
};
b2bi.untagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • ResourceARN — (String)

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

    • TagKeys — (Array<String>)

      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.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateCapability(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the updateCapability operation

var params = {
  capabilityId: 'STRING_VALUE', /* required */
  configuration: {
    edi: {
      inputLocation: { /* required */
        bucketName: 'STRING_VALUE',
        key: 'STRING_VALUE'
      },
      outputLocation: { /* required */
        bucketName: 'STRING_VALUE',
        key: 'STRING_VALUE'
      },
      transformerId: 'STRING_VALUE', /* required */
      type: { /* required */
        x12Details: {
          transactionSet: X12_110 | X12_180 | X12_204 | X12_210 | X12_211 | X12_214 | X12_215 | X12_259 | X12_260 | X12_266 | X12_269 | X12_270 | X12_271 | X12_274 | X12_275 | X12_276 | X12_277 | X12_278 | X12_310 | X12_315 | X12_322 | X12_404 | X12_410 | X12_417 | X12_421 | X12_426 | X12_810 | X12_820 | X12_824 | X12_830 | X12_832 | X12_834 | X12_835 | X12_837 | X12_844 | X12_846 | X12_849 | X12_850 | X12_852 | X12_855 | X12_856 | X12_860 | X12_861 | X12_864 | X12_865 | X12_869 | X12_870 | X12_940 | X12_945 | X12_990 | X12_997 | 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_5010 | VERSION_5010_HIPAA
        }
      }
    }
  },
  instructionsDocuments: [
    {
      bucketName: 'STRING_VALUE',
      key: 'STRING_VALUE'
    },
    /* more items */
  ],
  name: 'STRING_VALUE'
};
b2bi.updateCapability(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • capabilityId — (String)

      Specifies a system-assigned unique identifier for the capability.

    • name — (String)

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

    • configuration — (map)

      Specifies a structure that contains the details for a capability.

      • edi — (map)

        An EDI (electronic data interchange) configuration object.

        • typerequired — (map)

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

          • x12Details — (map)

            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.

              Possible values include:
              • "X12_110"
              • "X12_180"
              • "X12_204"
              • "X12_210"
              • "X12_211"
              • "X12_214"
              • "X12_215"
              • "X12_259"
              • "X12_260"
              • "X12_266"
              • "X12_269"
              • "X12_270"
              • "X12_271"
              • "X12_274"
              • "X12_275"
              • "X12_276"
              • "X12_277"
              • "X12_278"
              • "X12_310"
              • "X12_315"
              • "X12_322"
              • "X12_404"
              • "X12_410"
              • "X12_417"
              • "X12_421"
              • "X12_426"
              • "X12_810"
              • "X12_820"
              • "X12_824"
              • "X12_830"
              • "X12_832"
              • "X12_834"
              • "X12_835"
              • "X12_837"
              • "X12_844"
              • "X12_846"
              • "X12_849"
              • "X12_850"
              • "X12_852"
              • "X12_855"
              • "X12_856"
              • "X12_860"
              • "X12_861"
              • "X12_864"
              • "X12_865"
              • "X12_869"
              • "X12_870"
              • "X12_940"
              • "X12_945"
              • "X12_990"
              • "X12_997"
              • "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 — (String)

              Returns the version to use for the specified X12 transaction set.

               </p> 
              Possible values include:
              • "VERSION_4010"
              • "VERSION_4030"
              • "VERSION_5010"
              • "VERSION_5010_HIPAA"
        • inputLocationrequired — (map)

          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.

        • outputLocationrequired — (map)

          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.

        • transformerIdrequired — (String)

          Returns the system-assigned unique identifier for the transformer.

    • instructionsDocuments — (Array<map>)

      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.

      • bucketName — (String)

        Specifies the name of the Amazon S3 bucket.

      • key — (String)

        Specifies the Amazon S3 key for the file location.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "edi"
      • configuration — (map)

        Returns a structure that contains the details for a capability.

        • edi — (map)

          An EDI (electronic data interchange) configuration object.

          • typerequired — (map)

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

            • x12Details — (map)

              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.

                Possible values include:
                • "X12_110"
                • "X12_180"
                • "X12_204"
                • "X12_210"
                • "X12_211"
                • "X12_214"
                • "X12_215"
                • "X12_259"
                • "X12_260"
                • "X12_266"
                • "X12_269"
                • "X12_270"
                • "X12_271"
                • "X12_274"
                • "X12_275"
                • "X12_276"
                • "X12_277"
                • "X12_278"
                • "X12_310"
                • "X12_315"
                • "X12_322"
                • "X12_404"
                • "X12_410"
                • "X12_417"
                • "X12_421"
                • "X12_426"
                • "X12_810"
                • "X12_820"
                • "X12_824"
                • "X12_830"
                • "X12_832"
                • "X12_834"
                • "X12_835"
                • "X12_837"
                • "X12_844"
                • "X12_846"
                • "X12_849"
                • "X12_850"
                • "X12_852"
                • "X12_855"
                • "X12_856"
                • "X12_860"
                • "X12_861"
                • "X12_864"
                • "X12_865"
                • "X12_869"
                • "X12_870"
                • "X12_940"
                • "X12_945"
                • "X12_990"
                • "X12_997"
                • "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 — (String)

                Returns the version to use for the specified X12 transaction set.

                 </p> 
                Possible values include:
                • "VERSION_4010"
                • "VERSION_4030"
                • "VERSION_5010"
                • "VERSION_5010_HIPAA"
          • inputLocationrequired — (map)

            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.

          • outputLocationrequired — (map)

            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.

          • transformerIdrequired — (String)

            Returns the system-assigned unique identifier for the transformer.

      • instructionsDocuments — (Array<map>)

        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.

        • bucketName — (String)

          Specifies the name of the Amazon S3 bucket.

        • key — (String)

          Specifies the Amazon S3 key for the file location.

      • createdAt — (Date)

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

      • modifiedAt — (Date)

        Returns a timestamp for last time the capability was modified.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updatePartnership(params = {}, callback) ⇒ AWS.Request

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.

Service Reference:

Examples:

Calling the updatePartnership operation

var params = {
  partnershipId: 'STRING_VALUE', /* required */
  capabilities: [
    'STRING_VALUE',
    /* more items */
  ],
  name: 'STRING_VALUE'
};
b2bi.updatePartnership(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • partnershipId — (String)

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

    • name — (String)

      The name of the partnership, used to identify it.

    • capabilities — (Array<String>)

      List of the capabilities associated with this partnership.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

      • 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 — (Array<String>)

        Returns one or more capabilities associated with this partnership.

      • tradingPartnerId — (String)

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

      • createdAt — (Date)

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

      • modifiedAt — (Date)

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

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateProfile(params = {}, callback) ⇒ AWS.Request

Updates the specified parameters for a profile. A profile is the mechanism used to create the concept of a private network.

Service Reference:

Examples:

Calling the updateProfile operation

var params = {
  profileId: 'STRING_VALUE', /* required */
  businessName: 'STRING_VALUE',
  email: 'STRING_VALUE',
  name: 'STRING_VALUE',
  phone: 'STRING_VALUE'
};
b2bi.updateProfile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • profileId — (String)

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

    • name — (String)

      The name of the profile, used to identify it.

    • email — (String)

      Specifies the email address associated with this customer profile.

    • phone — (String)

      Specifies the phone number associated with the profile.

    • businessName — (String)

      Specifies the name for the business associated with this profile.

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "ENABLED"
        • "DISABLED"
      • logGroupName — (String)

        Returns the name of the logging group.

      • createdAt — (Date)

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

      • modifiedAt — (Date)

        Returns a timestamp for last time the profile was modified.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.

updateTransformer(params = {}, callback) ⇒ AWS.Request

Updates the specified parameters for a transformer. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.

Service Reference:

Examples:

Calling the updateTransformer operation

var params = {
  transformerId: 'STRING_VALUE', /* required */
  ediType: {
    x12Details: {
      transactionSet: X12_110 | X12_180 | X12_204 | X12_210 | X12_211 | X12_214 | X12_215 | X12_259 | X12_260 | X12_266 | X12_269 | X12_270 | X12_271 | X12_274 | X12_275 | X12_276 | X12_277 | X12_278 | X12_310 | X12_315 | X12_322 | X12_404 | X12_410 | X12_417 | X12_421 | X12_426 | X12_810 | X12_820 | X12_824 | X12_830 | X12_832 | X12_834 | X12_835 | X12_837 | X12_844 | X12_846 | X12_849 | X12_850 | X12_852 | X12_855 | X12_856 | X12_860 | X12_861 | X12_864 | X12_865 | X12_869 | X12_870 | X12_940 | X12_945 | X12_990 | X12_997 | 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_5010 | VERSION_5010_HIPAA
    }
  },
  fileFormat: XML | JSON,
  mappingTemplate: 'STRING_VALUE',
  name: 'STRING_VALUE',
  sampleDocument: 'STRING_VALUE',
  status: active | inactive
};
b2bi.updateTransformer(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

  • params (Object) (defaults to: {})
    • transformerId — (String)

      Specifies the system-assigned unique identifier for the transformer.

    • name — (String)

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

    • fileFormat — (String)

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

      Possible values include:
      • "XML"
      • "JSON"
    • mappingTemplate — (String)

      Specifies the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.

    • status — (String)

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

      Possible values include:
      • "active"
      • "inactive"
    • ediType — (map)

      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 — (map)

        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.

          Possible values include:
          • "X12_110"
          • "X12_180"
          • "X12_204"
          • "X12_210"
          • "X12_211"
          • "X12_214"
          • "X12_215"
          • "X12_259"
          • "X12_260"
          • "X12_266"
          • "X12_269"
          • "X12_270"
          • "X12_271"
          • "X12_274"
          • "X12_275"
          • "X12_276"
          • "X12_277"
          • "X12_278"
          • "X12_310"
          • "X12_315"
          • "X12_322"
          • "X12_404"
          • "X12_410"
          • "X12_417"
          • "X12_421"
          • "X12_426"
          • "X12_810"
          • "X12_820"
          • "X12_824"
          • "X12_830"
          • "X12_832"
          • "X12_834"
          • "X12_835"
          • "X12_837"
          • "X12_844"
          • "X12_846"
          • "X12_849"
          • "X12_850"
          • "X12_852"
          • "X12_855"
          • "X12_856"
          • "X12_860"
          • "X12_861"
          • "X12_864"
          • "X12_865"
          • "X12_869"
          • "X12_870"
          • "X12_940"
          • "X12_945"
          • "X12_990"
          • "X12_997"
          • "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 — (String)

          Returns the version to use for the specified X12 transaction set.

           </p> 
          Possible values include:
          • "VERSION_4010"
          • "VERSION_4030"
          • "VERSION_5010"
          • "VERSION_5010_HIPAA"
    • sampleDocument — (String)

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

Callback (callback):

  • function(err, data) { ... }

    Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

    Context (this):

    • (AWS.Response)

      the response object containing error, data properties, and the original request object.

    Parameters:

    • err (Error)

      the error object returned from the request. Set to null if the request is successful.

    • data (Object)

      the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

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

        Possible values include:
        • "XML"
        • "JSON"
      • mappingTemplate — (String)

        Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.

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

        Possible values include:
        • "active"
        • "inactive"
      • ediType — (map)

        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 — (map)

          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.

            Possible values include:
            • "X12_110"
            • "X12_180"
            • "X12_204"
            • "X12_210"
            • "X12_211"
            • "X12_214"
            • "X12_215"
            • "X12_259"
            • "X12_260"
            • "X12_266"
            • "X12_269"
            • "X12_270"
            • "X12_271"
            • "X12_274"
            • "X12_275"
            • "X12_276"
            • "X12_277"
            • "X12_278"
            • "X12_310"
            • "X12_315"
            • "X12_322"
            • "X12_404"
            • "X12_410"
            • "X12_417"
            • "X12_421"
            • "X12_426"
            • "X12_810"
            • "X12_820"
            • "X12_824"
            • "X12_830"
            • "X12_832"
            • "X12_834"
            • "X12_835"
            • "X12_837"
            • "X12_844"
            • "X12_846"
            • "X12_849"
            • "X12_850"
            • "X12_852"
            • "X12_855"
            • "X12_856"
            • "X12_860"
            • "X12_861"
            • "X12_864"
            • "X12_865"
            • "X12_869"
            • "X12_870"
            • "X12_940"
            • "X12_945"
            • "X12_990"
            • "X12_997"
            • "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 — (String)

            Returns the version to use for the specified X12 transaction set.

             </p> 
            Possible values include:
            • "VERSION_4010"
            • "VERSION_4030"
            • "VERSION_5010"
            • "VERSION_5010_HIPAA"
      • sampleDocument — (String)

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

      • createdAt — (Date)

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

      • modifiedAt — (Date)

        Returns a timestamp for last time the transformer was modified.

Returns:

  • (AWS.Request)

    a handle to the operation request for subsequent event callback registration.