action storecove_create_additional_tax_identifier {
  label: "Create a new AdditionalTaxIdentifier"
  description: "Create a new AdditionalTaxIdentifier. An AdditionalTaxIdentifier is a seconday tax identifier that is used inside the EU when sending invoices to consumers. In that case, the VAT of the receiving country is used and if the sender has a local VAT identifier, that is used to identifiy the sender, instead of the sender's origin country VAT number. To use these identifiers, use the invoice.consumerTaxMode = true property."
  provider: storecove
  method: POST
  path: "/legal_entities/{legal_entity_id}/additional_tax_identifiers"
  encoding: json
  input: {
    type: "object"
    properties: {
      country: {
        type: "string"
        description: "The ISO3166 country code to use this identifier for in case of consumerTaxMode."
      }
      county: {
        type: "string"
        description: "The county/state inside the country code to use this identifier for in case of consumerTaxMode. Leave empty to create an additional tax identifier for the entire country. For India, use the two last characters of ISO 3166-2:IN (https://en.wikipedia.org/wiki/States_and_union_territories_of_India)."
      }
      identifier: {
        type: "string"
        description: "The identifier."
      }
      legal_entity_id: {
        type: "integer"
        format: "int64"
      }
      scheme: {
        type: "string"
        description: "The scheme of the identifier."
      }
      superscheme: {
        type: "string"
        description: "The superscheme of the identifier. Should always be \"iso6523-actorid-upis\"."
      }
      third_party_password: {
        type: "string"
        description: "The password to use to authenticate to a system through which to send the document, or to obtain tax authority approval to send it. This field is currently relevant only for India and mandatory when creating an IN tax identifier."
      }
      third_party_username: {
        type: "string"
        description: "The username to use to authenticate to a system through which to send the document, or to obtain tax authority approval to send it. This field is currently relevant only for India and mandatory when creating an IN tax identifier."
      }
    }
    required: ["country", "identifier", "legal_entity_id", "scheme", "superscheme"]
    additionalProperties: false
  }
  output: {
    properties: {
      country: {
        type: "string"
        description: "The ISO3166 country code to use this identifier for in case of consumerTaxMode."
      }
      county: {
        type: "string"
        description: "The county/state inside the country code to use this identifier for in case of consumerTaxMode."
      }
      id: {
        type: "integer"
        format: "int64"
        description: "The Storecove assigned id for the AdditionalTaxIdentifier."
      }
      identifier: {
        type: "string"
        description: "The identifier."
      }
      scheme: {
        type: "string"
        description: "The scheme of the identifier."
      }
      superscheme: {
        type: "string"
        description: "The superscheme of the identifier."
      }
    }
  }
}