Jump to

• Request
• Response

listTaxProcessors

get

/ccadmin/v1/taxProcessors

List Tax Processors. Get a list of tax processors.

Request

Supported Media Types

• application/json

Query Parameters

• type: string
  If set, only returns tax processor accounts of given tax processor type.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Following model is returned when operation succeeds.

Body ()

Root Schema : listTaxProcessors_response

Type: object

Show Source

• items(optional): array items
  The list of tax processors.

{
    "properties":{
        "items":{
            "description":"The list of tax processors.",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "country":{
                        "description":"Country Name.",
                        "type":"string"
                    },
                    "city":{
                        "description":"City name.",
                        "type":"string"
                    },
                    "defaultTaxRate":{
                        "description":"Indicates the tax rate used in case of fallback",
                        "type":"number"
                    },
                    "postalCode":{
                        "description":"Postal code.",
                        "type":"string"
                    },
                    "hasPassword":{
                        "description":"Indicates whether password is set or not.",
                        "type":"boolean"
                    },
                    "type":{
                        "description":"Name of the tax processor used.",
                        "type":"string"
                    },
                    "isActive":{
                        "description":"Status if tax account is active.",
                        "type":"boolean"
                    },
                    "url":{
                        "description":"Url of tax processor rest endpoint.",
                        "type":"string"
                    },
                    "fallbackEnabled":{
                        "description":"Indicates whether fallback tax calculation is enabled in case of failures",
                        "type":"boolean"
                    },
                    "merchantId":{
                        "description":"Unique identifier of merchant.",
                        "type":"string"
                    },
                    "repositoryId":{
                        "description":"The ID of the tax processor item.",
                        "type":"string"
                    },
                    "addressLine1":{
                        "description":"Address Line 1.",
                        "type":"string"
                    },
                    "addressLine2":{
                        "description":"Address Line 2.",
                        "type":"string"
                    },
                    "addressLine3":{
                        "description":"Address Line 3.",
                        "type":"string"
                    },
                    "region":{
                        "description":"Region or State name.",
                        "type":"string"
                    },
                    "showTaxSummary":{
                        "description":"whether to show tax summary or not",
                        "type":"boolean"
                    },
                    "username":{
                        "description":"Registered username with tax processor.",
                        "type":"string"
                    }
                }
            }
        }
    }
}

Nested Schema : items

Type: array

The list of tax processors.

Show Source

• Array of: object items

{
    "description":"The list of tax processors.",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "country":{
                "description":"Country Name.",
                "type":"string"
            },
            "city":{
                "description":"City name.",
                "type":"string"
            },
            "defaultTaxRate":{
                "description":"Indicates the tax rate used in case of fallback",
                "type":"number"
            },
            "postalCode":{
                "description":"Postal code.",
                "type":"string"
            },
            "hasPassword":{
                "description":"Indicates whether password is set or not.",
                "type":"boolean"
            },
            "type":{
                "description":"Name of the tax processor used.",
                "type":"string"
            },
            "isActive":{
                "description":"Status if tax account is active.",
                "type":"boolean"
            },
            "url":{
                "description":"Url of tax processor rest endpoint.",
                "type":"string"
            },
            "fallbackEnabled":{
                "description":"Indicates whether fallback tax calculation is enabled in case of failures",
                "type":"boolean"
            },
            "merchantId":{
                "description":"Unique identifier of merchant.",
                "type":"string"
            },
            "repositoryId":{
                "description":"The ID of the tax processor item.",
                "type":"string"
            },
            "addressLine1":{
                "description":"Address Line 1.",
                "type":"string"
            },
            "addressLine2":{
                "description":"Address Line 2.",
                "type":"string"
            },
            "addressLine3":{
                "description":"Address Line 3.",
                "type":"string"
            },
            "region":{
                "description":"Region or State name.",
                "type":"string"
            },
            "showTaxSummary":{
                "description":"whether to show tax summary or not",
                "type":"boolean"
            },
            "username":{
                "description":"Registered username with tax processor.",
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• addressLine1(optional): string
  Address Line 1.
• addressLine2(optional): string
  Address Line 2.
• addressLine3(optional): string
  Address Line 3.
• city(optional): string
  City name.
• country(optional): string
  Country Name.
• defaultTaxRate(optional): number
  Indicates the tax rate used in case of fallback
• fallbackEnabled(optional): boolean
  Indicates whether fallback tax calculation is enabled in case of failures
• hasPassword(optional): boolean
  Indicates whether password is set or not.
• isActive(optional): boolean
  Status if tax account is active.
• merchantId(optional): string
  Unique identifier of merchant.
• postalCode(optional): string
  Postal code.
• region(optional): string
  Region or State name.
• repositoryId(optional): string
  The ID of the tax processor item.
• showTaxSummary(optional): boolean
  whether to show tax summary or not
• type(optional): string
  Name of the tax processor used.
• url(optional): string
  Url of tax processor rest endpoint.
• username(optional): string
  Registered username with tax processor.

{
    "type":"object",
    "properties":{
        "country":{
            "description":"Country Name.",
            "type":"string"
        },
        "city":{
            "description":"City name.",
            "type":"string"
        },
        "defaultTaxRate":{
            "description":"Indicates the tax rate used in case of fallback",
            "type":"number"
        },
        "postalCode":{
            "description":"Postal code.",
            "type":"string"
        },
        "hasPassword":{
            "description":"Indicates whether password is set or not.",
            "type":"boolean"
        },
        "type":{
            "description":"Name of the tax processor used.",
            "type":"string"
        },
        "isActive":{
            "description":"Status if tax account is active.",
            "type":"boolean"
        },
        "url":{
            "description":"Url of tax processor rest endpoint.",
            "type":"string"
        },
        "fallbackEnabled":{
            "description":"Indicates whether fallback tax calculation is enabled in case of failures",
            "type":"boolean"
        },
        "merchantId":{
            "description":"Unique identifier of merchant.",
            "type":"string"
        },
        "repositoryId":{
            "description":"The ID of the tax processor item.",
            "type":"string"
        },
        "addressLine1":{
            "description":"Address Line 1.",
            "type":"string"
        },
        "addressLine2":{
            "description":"Address Line 2.",
            "type":"string"
        },
        "addressLine3":{
            "description":"Address Line 3.",
            "type":"string"
        },
        "region":{
            "description":"Region or State name.",
            "type":"string"
        },
        "showTaxSummary":{
            "description":"whether to show tax summary or not",
            "type":"boolean"
        },
        "username":{
            "description":"Registered username with tax processor.",
            "type":"string"
        }
    }
}

Example Response (application/json)

[
    {
        "country":null,
        "city":null,
        "defaultTaxRate":6,
        "postalCode":null,
        "hasPassword":false,
        "isActive":null,
        "type":"avalara",
        "enabled":false,
        "url":null,
        "fallbackEnabled":false,
        "merchantId":null,
        "addressLine1":null,
        "region":null,
        "showTaxSummary":true,
        "username":null
    },
    {
        "country":"US",
        "city":"alabama",
        "defaultTaxRate":6,
        "postalCode":"454455",
        "hasPassword":true,
        "type":"avalara",
        "enabled":true,
        "url":"https://development.avalara.net/1.0/tax/get",
        "fallbackEnabled":false,
        "merchantId":"333",
        "addressLine1":"abc",
        "addressLine2":"abc",
        "region":"al",
        "showTaxSummary":true,
        "username":"Karna"
    }
]

Default Response

The error response. The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud: |Error Code|Description| |------------------|------------------| |35003|If there is internal error while getting tax processor.| |35001|If no tax processor found with the given ID.|

Body ()

Root Schema : errorModel

Type: object

Show Source

• devMessage(optional): string
  An optional non-localized message containing technical information for developers
• errorCode(optional): string
  The numerical code identifying the error
• errors(optional): array errors
  An optional list of errors if multiple errors were encountered
• message(optional): string
  The localized message describing the error
• moreInfo(optional): string
  An optional non-localized message with more information
• o:errorPath(optional): string
  An optional machine readable description of where the error occurred
• status(optional): string
  The HTTP status code
• type(optional): string
  The URI to the HTTP state code definition

{
    "type":"object",
    "properties":{
        "errorCode":{
            "description":"The numerical code identifying the error",
            "type":"string"
        },
        "message":{
            "description":"The localized message describing the error",
            "type":"string"
        },
        "type":{
            "description":"The URI to the HTTP state code definition",
            "type":"string"
        },
        "devMessage":{
            "description":"An optional non-localized message containing technical information for developers",
            "type":"string"
        },
        "moreInfo":{
            "description":"An optional non-localized message with more information",
            "type":"string"
        },
        "o:errorPath":{
            "description":"An optional machine readable description of where the error occurred",
            "type":"string"
        },
        "errors":{
            "description":"An optional list of errors if multiple errors were encountered",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "errorCode":{
                        "description":"The numerical code identifying the error",
                        "type":"string"
                    },
                    "message":{
                        "description":"The localized message describing the error",
                        "type":"string"
                    },
                    "devMessage":{
                        "description":"An optional non-localized message containing technical information for developers",
                        "type":"string"
                    },
                    "moreInfo":{
                        "description":"An optional non-localized message with more information",
                        "type":"string"
                    },
                    "o:errorPath":{
                        "description":"An optional machine readable description of where the error occurred",
                        "type":"string"
                    },
                    "status":{
                        "description":"The HTTP status code",
                        "type":"string"
                    }
                }
            }
        },
        "status":{
            "description":"The HTTP status code",
            "type":"string"
        }
    }
}

Nested Schema : errors

Type: array

An optional list of errors if multiple errors were encountered

Show Source

• Array of: object items

{
    "description":"An optional list of errors if multiple errors were encountered",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "errorCode":{
                "description":"The numerical code identifying the error",
                "type":"string"
            },
            "message":{
                "description":"The localized message describing the error",
                "type":"string"
            },
            "devMessage":{
                "description":"An optional non-localized message containing technical information for developers",
                "type":"string"
            },
            "moreInfo":{
                "description":"An optional non-localized message with more information",
                "type":"string"
            },
            "o:errorPath":{
                "description":"An optional machine readable description of where the error occurred",
                "type":"string"
            },
            "status":{
                "description":"The HTTP status code",
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• devMessage(optional): string
  An optional non-localized message containing technical information for developers
• errorCode(optional): string
  The numerical code identifying the error
• message(optional): string
  The localized message describing the error
• moreInfo(optional): string
  An optional non-localized message with more information
• o:errorPath(optional): string
  An optional machine readable description of where the error occurred
• status(optional): string
  The HTTP status code

{
    "type":"object",
    "properties":{
        "errorCode":{
            "description":"The numerical code identifying the error",
            "type":"string"
        },
        "message":{
            "description":"The localized message describing the error",
            "type":"string"
        },
        "devMessage":{
            "description":"An optional non-localized message containing technical information for developers",
            "type":"string"
        },
        "moreInfo":{
            "description":"An optional non-localized message with more information",
            "type":"string"
        },
        "o:errorPath":{
            "description":"An optional machine readable description of where the error occurred",
            "type":"string"
        },
        "status":{
            "description":"The HTTP status code",
            "type":"string"
        }
    }
}

Back to Top