> ## Documentation Index
> Fetch the complete documentation index at: https://docs.erp.arukz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create fiscal position

> Create a new fiscal position



## OpenAPI

````yaml /api-reference/openapi.json post /admin/api/v1/accounts/fiscal-positions
openapi: 3.0.3
info:
  title: ARUKZ ERP API
  version: v1
  description: >-
    The REST API of ARUKZ ERP: sales, purchases, inventory, products, partners,
    accounts, projects and reference data. Every call acts as the user whose
    token it carries and sees only that user's company.
servers:
  - url: https://erp.arukz.com
    description: ARUKZ ERP (hosted)
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Sign in for a token and sign out.
  - name: Sales
    description: Quotations, sales orders and their lines, deliveries and invoices.
  - name: Purchases
    description: Purchase orders, receipts, bills, agreements and vendor price lists.
  - name: Inventory
    description: >-
      Warehouses, locations, lots, stock quantities, receipts, deliveries,
      transfers and scrap.
  - name: Products
    description: 'The product catalogue: categories, attributes, variants and packaging.'
  - name: Partners
    description: Customers, vendors, contacts, addresses and bank accounts.
  - name: Accounts
    description: >-
      Invoices, bills, credit notes, refunds, taxes, journals and the chart of
      accounts.
  - name: Projects
    description: Projects, tasks, stages and milestones.
  - name: Reference data
    description: Currencies and rates, banks, countries, states and units of measure.
paths:
  /admin/api/v1/accounts/fiscal-positions:
    post:
      tags:
        - Accounts
      summary: Create fiscal position
      description: Create a new fiscal position
      operationId: accounts-fiscal-positions-create-fiscal-position
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: >-
                    Fiscal position name. Must not be greater than 255
                    characters.
                  example: Domestic
                company_id:
                  type: integer
                  description: >-
                    Company ID. The `id` of an existing record in the companies
                    table.
                  example: 1
                country_id:
                  type: integer
                  description: >-
                    Country ID. The `id` of an existing record in the countries
                    table.
                  nullable: true
                  example: 233
                country_group_id:
                  type: integer
                  description: >-
                    Country group ID. The `id` of an existing record in the
                    countries table.
                  nullable: true
                zip_from:
                  type: string
                  description: ZIP code from. Must not be greater than 10 characters.
                  nullable: true
                  example: '10000'
                zip_to:
                  type: string
                  description: ZIP code to. Must not be greater than 10 characters.
                  nullable: true
                  example: '99999'
                notes:
                  type: string
                  description: Fiscal position notes.
                  nullable: true
                  example: For domestic transactions
                auto_reply:
                  type: boolean
                  description: Auto reply enabled.
                  nullable: true
                  example: false
                vat_required:
                  type: boolean
                  description: VAT required flag.
                  nullable: true
                  example: false
                foreign_vat:
                  type: string
                  description: Foreign VAT. Must not be greater than 255 characters.
                  nullable: true
                taxes:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: >-
                          The `id` of an existing record in the
                          accounts_fiscal_position_taxes table.
                        example: 16
                      tax_source_id:
                        type: integer
                        description: >-
                          The `id` of an existing record in the accounts_taxes
                          table.
                        example: 16
                      tax_destination_id:
                        type: integer
                        description: >-
                          The `id` of an existing record in the accounts_taxes
                          table.
                        nullable: true
                        example: 16
                    required:
                      - tax_source_id
                  description: Tax mappings array. Include id for update, omit for create.
                  nullable: true
                  example:
                    - tax_source_id: 1
                      tax_destination_id: 2
                accounts:
                  type: array
                  items:
                    type: object
                    properties:
                      id:
                        type: integer
                        description: >-
                          The `id` of an existing record in the
                          accounts_fiscal_position_accounts table.
                        example: 16
                      account_source_id:
                        type: integer
                        description: >-
                          The `id` of an existing record in the
                          accounts_accounts table.
                        example: 16
                      account_destination_id:
                        type: integer
                        description: >-
                          The `id` of an existing record in the
                          accounts_accounts table.
                        example: 16
                    required:
                      - account_destination_id
                      - account_source_id
                  description: >-
                    Account mappings array. Include id for update, omit for
                    create.
                  nullable: true
                  example:
                    - account_source_id: 5
                      account_destination_id: 6
              required:
                - company_id
                - name
      responses:
        '201':
          description: Created
          content:
            application/json:
              example:
                data:
                  id: null
                  company_id: 1361
                  country_id: 368
                  country_group_id: null
                  creator_id: 1
                  name: eius et
                  zip_from: null
                  zip_to: null
                  foreign_vat: null
                  notes: null
                  auto_reply: false
                  vat_required: false
                  sort: 0
                  created_at: null
                  updated_at: null
                message: Fiscal position created successfully.
        '401':
          description: Unauthenticated
          content:
            application/json:
              example:
                message: Unauthenticated.
        '422':
          description: Validation error
          content:
            application/json:
              example:
                message: The given data was invalid.
                errors:
                  name:
                    - The name field is required.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API token from [Sign in](/api-reference/authentication), sent as
        `Authorization: Bearer <token>`. Tokens last 30 days.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.