---
title: "Cadastra um novo pedido de vistoria na API do Rede Vistorias."
method: POST
path: "/orders"
tags: ["Pedidos"]
---

# Cadastra um novo pedido de vistoria na API do Rede Vistorias.

`POST /orders`

O retorno é o código cadastrado da vistoria, e o preço que será consumido do pacote contratado pelo cliente, em metros quadrados.<br /> No caso do pedido de saída ou de conferência, deve ser informada a inspeção anterior. Isto pode ser feito de duas formas, fazendo o upload de um arquivo (ver <a href="#tag/Upload-URL">Upload URL</a>) ou informando um link já existente, que será processado por nossa plataforma.

## Headers

- `Authorization` string, required

## Request body

- union
  - PedidoEntrada
    - `details` Detail, required
      - `building_id` string, required — Identificação do imóvel.
      - `building_type` 'Apartamento' | 'Casa' | 'Galpão' | 'Garagem' | 'Kitinete' | 'Loft' | 'Loja' | 'Prédio' | 'Sala' | 'Duplex' | 'Terreno', required
      - `area` unknown, required
      - `inspection_type` 'entrada' | 'saida' | 'transferencia' | 'conferencia', required
      - `purpose` 'Residencial' | 'Comercial' | 'Galpão'
      - `furnished` 'furnished' | 'semi-furnished' | 'unfurnished', required
      - `modality` 'standard' | 'premium', required — Modalidade do pedido.
      - `express` boolean, required — Opção por vistoria express.
      - `details` string — Informações adicionais importantes ao pedido, por exemplo, local das chaves, horário de retirada, etc.
      - `franchisee_id` integer — Código da unidade que está gerando o pedido. (Valor obtido na listagem de unidades) Essa key não deve ser informada caso não haja uma unidade (franchisee_id)
    - `address` Address, required
      - `street` string, required
      - `number` string, required
      - `complement` string
      - `zipcode` string, required
      - `neighborhood` string, required
      - `city` string, required
      - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO', required
    - `keys` Key
      - `simple` integer — Quantidade de chaves simples existentes para esse imóvel.
      - `foursided` integer — Quantidade de chaves "tetra" existentes para esse imóvel.
      - `others` string — Quantidade de outros tipos de chaves existentes para esse imóvel.
    - `cost` Cost
      - `condominium` number — Valor do condomínio.
      - `iptu` number — Valor do IPTU.
      - `rent` number — Valor do aluguel.
    - `people` unknown[]
      - unknown
    - `notes` string — Observações que irão aparecer no relatório final da vistoria.
    - `trace_data` TraceData
  - PedidoSaida
    - `details` Detail, required
      - `building_id` string, required — Identificação do imóvel.
      - `building_type` 'Apartamento' | 'Casa' | 'Galpão' | 'Garagem' | 'Kitinete' | 'Loft' | 'Loja' | 'Prédio' | 'Sala' | 'Duplex' | 'Terreno', required
      - `area` unknown, required
      - `inspection_type` 'entrada' | 'saida' | 'transferencia' | 'conferencia', required
      - `purpose` 'Residencial' | 'Comercial' | 'Galpão'
      - `furnished` 'furnished' | 'semi-furnished' | 'unfurnished', required
      - `modality` 'standard' | 'premium', required — Modalidade do pedido.
      - `express` boolean, required — Opção por vistoria express.
      - `details` string — Informações adicionais importantes ao pedido, por exemplo, local das chaves, horário de retirada, etc.
      - `franchisee_id` integer — Código da unidade que está gerando o pedido. (Valor obtido na listagem de unidades) Essa key não deve ser informada caso não haja uma unidade (franchisee_id)
    - `address` Address, required
      - `street` string, required
      - `number` string, required
      - `complement` string
      - `zipcode` string, required
      - `neighborhood` string, required
      - `city` string, required
      - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO', required
    - `keys` Key
      - `simple` integer — Quantidade de chaves simples existentes para esse imóvel.
      - `foursided` integer — Quantidade de chaves "tetra" existentes para esse imóvel.
      - `others` string — Quantidade de outros tipos de chaves existentes para esse imóvel.
    - `cost` Cost
      - `condominium` number — Valor do condomínio.
      - `iptu` number — Valor do IPTU.
      - `rent` number — Valor do aluguel.
    - `people` unknown[]
      - unknown
    - `previous_inspection` PreviousInspection, required
      - `file` File
        - `remote_name` string — Nome obtido utilizando a rota <a href="#operation/uploadURL">upload de arquivos</a>
        - `original_name` string — Nome original do arquivo
        - `extension` string — Formato pdf
      - `url` string
      - `code` string — Código do pedido de entrada (deve estar finalizado) que será base para o pedido de saída<br /> Obs. Esta informação deve ser fornecida caso não se utilize o arquivo para criação do pedido
    - `notes` string — Observações que irão aparecer no relatório final da vistoria.
    - `trace_data` TraceData
  - PedidoConferencia
    - `details` Detail, required
      - `building_id` string, required — Identificação do imóvel.
      - `building_type` 'Apartamento' | 'Casa' | 'Galpão' | 'Garagem' | 'Kitinete' | 'Loft' | 'Loja' | 'Prédio' | 'Sala' | 'Duplex' | 'Terreno', required
      - `area` unknown, required
      - `inspection_type` 'entrada' | 'saida' | 'transferencia' | 'conferencia', required
      - `purpose` 'Residencial' | 'Comercial' | 'Galpão'
      - `furnished` 'furnished' | 'semi-furnished' | 'unfurnished', required
      - `modality` 'standard' | 'premium', required — Modalidade do pedido.
      - `express` boolean, required — Opção por vistoria express.
      - `details` string — Informações adicionais importantes ao pedido, por exemplo, local das chaves, horário de retirada, etc.
      - `franchisee_id` integer — Código da unidade que está gerando o pedido. (Valor obtido na listagem de unidades) Essa key não deve ser informada caso não haja uma unidade (franchisee_id)
    - `address` Address, required
      - `street` string, required
      - `number` string, required
      - `complement` string
      - `zipcode` string, required
      - `neighborhood` string, required
      - `city` string, required
      - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO', required
    - `keys` Key
      - `simple` integer — Quantidade de chaves simples existentes para esse imóvel.
      - `foursided` integer — Quantidade de chaves "tetra" existentes para esse imóvel.
      - `others` string — Quantidade de outros tipos de chaves existentes para esse imóvel.
    - `cost` Cost
      - `condominium` number — Valor do condomínio.
      - `iptu` number — Valor do IPTU.
      - `rent` number — Valor do aluguel.
    - `people` unknown[]
      - unknown
    - `previous_inspection` PreviousInspection, required
      - `file` File
        - `remote_name` string — Nome obtido utilizando a rota <a href="#operation/uploadURL">upload de arquivos</a>
        - `original_name` string — Nome original do arquivo
        - `extension` string — Formato pdf
      - `url` string
      - `code` string — Código do pedido de entrada (deve estar finalizado) que será base para o pedido de saída<br /> Obs. Esta informação deve ser fornecida caso não se utilize o arquivo para criação do pedido
    - `notes` string — Observações que irão aparecer no relatório final da vistoria.
    - `trace_data` TraceData
  - PedidoTransferencia
    - `details` Detail, required
      - `building_id` string, required — Identificação do imóvel.
      - `building_type` 'Apartamento' | 'Casa' | 'Galpão' | 'Garagem' | 'Kitinete' | 'Loft' | 'Loja' | 'Prédio' | 'Sala' | 'Duplex' | 'Terreno', required
      - `area` unknown, required
      - `inspection_type` 'entrada' | 'saida' | 'transferencia' | 'conferencia', required
      - `purpose` 'Residencial' | 'Comercial' | 'Galpão'
      - `furnished` 'furnished' | 'semi-furnished' | 'unfurnished', required
      - `modality` 'standard' | 'premium', required — Modalidade do pedido.
      - `express` boolean, required — Opção por vistoria express.
      - `details` string — Informações adicionais importantes ao pedido, por exemplo, local das chaves, horário de retirada, etc.
      - `franchisee_id` integer — Código da unidade que está gerando o pedido. (Valor obtido na listagem de unidades) Essa key não deve ser informada caso não haja uma unidade (franchisee_id)
    - `address` Address, required
      - `street` string, required
      - `number` string, required
      - `complement` string
      - `zipcode` string, required
      - `neighborhood` string, required
      - `city` string, required
      - `state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO', required
    - `keys` Key
      - `simple` integer — Quantidade de chaves simples existentes para esse imóvel.
      - `foursided` integer — Quantidade de chaves "tetra" existentes para esse imóvel.
      - `others` string — Quantidade de outros tipos de chaves existentes para esse imóvel.
    - `cost` Cost
      - `condominium` number — Valor do condomínio.
      - `iptu` number — Valor do IPTU.
      - `rent` number — Valor do aluguel.
    - `people` unknown[]
      - unknown
    - `notes` string — Observações que irão aparecer no relatório final da vistoria.
    - `trace_data` TraceData

## Response `201`

OK

- object
  - `code` string — Código de identificação da vistoria.
  - `price` string — Preço a pagar pela vistoria.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized

---

[API](https://skmtc.dev/redevistorias/apis/rede-vistorias-erp-api.md) · [All operations](https://skmtc.dev/redevistorias/apis/rede-vistorias-erp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/redevistorias/rede-vistorias-erp-api/revisions/0be35aeec025/schema)