# Transportadora

transportadora

## GET /transportadora

> Obter Listagem de Transportadora

```json
{"openapi":"3.0.1","info":{"title":"Cadastros Gerais","version":"1.0"},"tags":[{"name":"Transportadora","description":"transportadora"}],"servers":[{"url":"https://localhost/cadastrosgerais/v10"},{"url":"http://localhost/cadastrosgerais/v10"}],"security":[{"csw_auth":[]}],"components":{"securitySchemes":{"csw_auth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ListaTransportadoras":{"type":"object","properties":{"continuationToken":{"type":"string","description":"Identificador da Paginação da Consulta"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Transportadora"}}}},"Transportadora":{"type":"object","properties":{"codEmpresa":{"type":"integer","description":"Código da Empresa da Transportadora"},"codTransportadora":{"type":"integer","description":"Código da Transportadora"},"nome":{"maxLength":60,"type":"string","description":"Nome da Transportadora"},"endereco":{"maxLength":60,"type":"string","description":"Endereço da Transportadora"},"cep":{"maxLength":8,"type":"string","description":"Código do CEP da Transportadora"},"cpfCnpj":{"type":"string","description":"Código do CPF ou CNPJ da Transportadora"},"nomeFantasia":{"maxLength":30,"type":"string","description":"Nome Fantasia da Transportadora"},"inscEstadual":{"maxLength":15,"type":"string","description":"Inscrição Estadual da Transportadora"},"situacao":{"type":"integer","description":"Situação da Transportadora (0-Inativo, 1-Ativo)","enum":[0,1]},"telefone":{"maxLength":15,"type":"string","description":"Telefone da Transportadora"},"teleFax":{"maxLength":15,"type":"string","description":"Telefone/Fax da Transportadora"},"bairro":{"maxLength":30,"type":"string","description":"Bairro da Transportadora"},"contato":{"maxLength":30,"type":"string","description":"Contato da Transportadora"},"email":{"maxLength":60,"type":"string","description":"E-mail da Transportadora"},"obsNotaFiscal":{"type":"integer","description":"Código da Observação para a Nota Fiscal"},"tipo":{"type":"integer","description":"Tipo da Transportadora (1-Transportadora, 2-Consignatário)","enum":[1,2]},"dataValidadeSeguro":{"type":"string","description":"Data de Validade do Seguro da Transportadora"},"paisCidadeExterior":{"type":"string","description":"País e Cidade do Exterior da Transportadora"},"paisBacen":{"maximum":999999,"type":"integer","description":"Código do Pais/Bacen da Transportadora"},"codRUC":{"maximum":99999999999,"type":"integer","description":"Código RUC da Transportadora"},"emailNfe":{"maxLength":60,"type":"string","description":"E-mail da Nota Fiscal Eletrônica da Transportadora"},"numero":{"maxLength":10,"type":"string","description":"Número do Endereço da Transportadora"},"rntrc":{"maxLength":14,"type":"string","description":"Registro Nacional de Transportador da Transportadora"},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}},"DadosCustomizados":{"required":["campo","valor"],"type":"object","properties":{"campo":{"type":"string"},"valor":{"type":"string"}}},"Erro":{"type":"object","properties":{"mensagem":{"type":"string"}}}}},"paths":{"/transportadora":{"get":{"tags":["Transportadora"],"summary":"Obter Listagem de Transportadora","operationId":"ObterTransportadoras","parameters":[{"name":"empresa","in":"header","description":"Código da Empresa","required":true,"schema":{"type":"string"}},{"name":"situacao","in":"query","description":"Situação da Transportadora (0-Inativo, 1-Ativo)","schema":{"type":"string"}},{"name":"continuationToken","in":"query","description":"Identificador da Paginação da Consulta","schema":{"type":"string"}},{"name":"campoFiltroDinamico","in":"query","description":"Campo para filtrar dinamicamente no SQL","schema":{"type":"string"}},{"name":"valorFiltroDinamico","in":"query","description":"Valor para filtrar dinamicamente no SQL","schema":{"type":"string"}},{"name":"paginacao","in":"query","description":"Quantidade de itens na paginação de retorno","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListaTransportadoras"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Erro"}}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}}}
```

## PUT /transportadora

> Cadastrar uma Transportadora

```json
{"openapi":"3.0.1","info":{"title":"Cadastros Gerais","version":"1.0"},"tags":[{"name":"Transportadora","description":"transportadora"}],"servers":[{"url":"https://localhost/cadastrosgerais/v10"},{"url":"http://localhost/cadastrosgerais/v10"}],"security":[{"csw_auth":[]}],"components":{"securitySchemes":{"csw_auth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"TransportadoraPut":{"type":"object","properties":{"codEmpresa":{"type":"integer","description":"Código da Empresa da Transportadora"},"codTransportadora":{"type":"integer","description":"Código da Transportadora"},"nome":{"maxLength":60,"type":"string","description":"Nome da Transportadora"},"endereco":{"maxLength":60,"type":"string","description":"Endereço da Transportadora"},"cep":{"maxLength":8,"type":"string","description":"Código do CEP da Transportadora (sem formatação)"},"cpfCnpj":{"type":"string","description":"Código do CPF ou CNPJ da Transportadora (sem formatação)"},"nomeFantasia":{"maxLength":30,"type":"string","description":"Nome Fantasia da Transportadora"},"inscEstadual":{"maxLength":15,"type":"string","description":"Inscrição Estadual da Transportadora (sem formatação)"},"situacao":{"type":"integer","description":"Situação da Transportadora (0-Inativo, 1-Ativo)","enum":[0,1]},"telefone":{"maxLength":15,"type":"string","description":"Telefone da Transportadora"},"teleFax":{"maxLength":15,"type":"string","description":"Telefone/Fax da Transportadora"},"bairro":{"maxLength":30,"type":"string","description":"Bairro da Transportadora"},"contato":{"maxLength":30,"type":"string","description":"Contato da Transportadora"},"email":{"maxLength":60,"type":"string","description":"E-mail da Transportadora"},"obsNotaFiscal":{"type":"integer","description":"Código da Observação para a Nota Fiscal"},"tipo":{"type":"integer","description":"Tipo da Transportadora (1-Transportadora, 2-Consignatário)","enum":[1,2]},"dataValidadeSeguro":{"type":"string","description":"Data de Validade do Seguro da Transportadora (YYYY-MM-DD)","format":"date"},"paisCidadeExterior":{"type":"string","description":"País e Cidade do Exterior da Transportadora"},"paisBacen":{"maximum":999999,"type":"integer","description":"Código do Pais/Bacen da Transportadora"},"codRUC":{"maximum":99999999999,"type":"integer","description":"Código RUC da Transportadora"},"emailNfe":{"maxLength":60,"type":"string","description":"E-mail da Nota Fiscal Eletrônica da Transportadora"},"numero":{"maxLength":10,"type":"string","description":"Número do Endereço da Transportadora"},"rntrc":{"maxLength":14,"type":"string","description":"Registro Nacional de Transportador da Transportadora"},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}},"DadosCustomizados":{"required":["campo","valor"],"type":"object","properties":{"campo":{"type":"string"},"valor":{"type":"string"}}},"Transportadora":{"type":"object","properties":{"codEmpresa":{"type":"integer","description":"Código da Empresa da Transportadora"},"codTransportadora":{"type":"integer","description":"Código da Transportadora"},"nome":{"maxLength":60,"type":"string","description":"Nome da Transportadora"},"endereco":{"maxLength":60,"type":"string","description":"Endereço da Transportadora"},"cep":{"maxLength":8,"type":"string","description":"Código do CEP da Transportadora"},"cpfCnpj":{"type":"string","description":"Código do CPF ou CNPJ da Transportadora"},"nomeFantasia":{"maxLength":30,"type":"string","description":"Nome Fantasia da Transportadora"},"inscEstadual":{"maxLength":15,"type":"string","description":"Inscrição Estadual da Transportadora"},"situacao":{"type":"integer","description":"Situação da Transportadora (0-Inativo, 1-Ativo)","enum":[0,1]},"telefone":{"maxLength":15,"type":"string","description":"Telefone da Transportadora"},"teleFax":{"maxLength":15,"type":"string","description":"Telefone/Fax da Transportadora"},"bairro":{"maxLength":30,"type":"string","description":"Bairro da Transportadora"},"contato":{"maxLength":30,"type":"string","description":"Contato da Transportadora"},"email":{"maxLength":60,"type":"string","description":"E-mail da Transportadora"},"obsNotaFiscal":{"type":"integer","description":"Código da Observação para a Nota Fiscal"},"tipo":{"type":"integer","description":"Tipo da Transportadora (1-Transportadora, 2-Consignatário)","enum":[1,2]},"dataValidadeSeguro":{"type":"string","description":"Data de Validade do Seguro da Transportadora"},"paisCidadeExterior":{"type":"string","description":"País e Cidade do Exterior da Transportadora"},"paisBacen":{"maximum":999999,"type":"integer","description":"Código do Pais/Bacen da Transportadora"},"codRUC":{"maximum":99999999999,"type":"integer","description":"Código RUC da Transportadora"},"emailNfe":{"maxLength":60,"type":"string","description":"E-mail da Nota Fiscal Eletrônica da Transportadora"},"numero":{"maxLength":10,"type":"string","description":"Número do Endereço da Transportadora"},"rntrc":{"maxLength":14,"type":"string","description":"Registro Nacional de Transportador da Transportadora"},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}},"Erro":{"type":"object","properties":{"mensagem":{"type":"string"}}}}},"paths":{"/transportadora":{"put":{"tags":["Transportadora"],"summary":"Cadastrar uma Transportadora","operationId":"CadastrarTransportadora","parameters":[{"name":"empresa","in":"header","description":"Código da Empresa","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Dados da Transportadora","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransportadoraPut"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transportadora"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Erro"}}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}}}
```

## GET /transportadora/{id}

> Obter uma Transportadora

```json
{"openapi":"3.0.1","info":{"title":"Cadastros Gerais","version":"1.0"},"tags":[{"name":"Transportadora","description":"transportadora"}],"servers":[{"url":"https://localhost/cadastrosgerais/v10"},{"url":"http://localhost/cadastrosgerais/v10"}],"security":[{"csw_auth":[]}],"components":{"securitySchemes":{"csw_auth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"Transportadora":{"type":"object","properties":{"codEmpresa":{"type":"integer","description":"Código da Empresa da Transportadora"},"codTransportadora":{"type":"integer","description":"Código da Transportadora"},"nome":{"maxLength":60,"type":"string","description":"Nome da Transportadora"},"endereco":{"maxLength":60,"type":"string","description":"Endereço da Transportadora"},"cep":{"maxLength":8,"type":"string","description":"Código do CEP da Transportadora"},"cpfCnpj":{"type":"string","description":"Código do CPF ou CNPJ da Transportadora"},"nomeFantasia":{"maxLength":30,"type":"string","description":"Nome Fantasia da Transportadora"},"inscEstadual":{"maxLength":15,"type":"string","description":"Inscrição Estadual da Transportadora"},"situacao":{"type":"integer","description":"Situação da Transportadora (0-Inativo, 1-Ativo)","enum":[0,1]},"telefone":{"maxLength":15,"type":"string","description":"Telefone da Transportadora"},"teleFax":{"maxLength":15,"type":"string","description":"Telefone/Fax da Transportadora"},"bairro":{"maxLength":30,"type":"string","description":"Bairro da Transportadora"},"contato":{"maxLength":30,"type":"string","description":"Contato da Transportadora"},"email":{"maxLength":60,"type":"string","description":"E-mail da Transportadora"},"obsNotaFiscal":{"type":"integer","description":"Código da Observação para a Nota Fiscal"},"tipo":{"type":"integer","description":"Tipo da Transportadora (1-Transportadora, 2-Consignatário)","enum":[1,2]},"dataValidadeSeguro":{"type":"string","description":"Data de Validade do Seguro da Transportadora"},"paisCidadeExterior":{"type":"string","description":"País e Cidade do Exterior da Transportadora"},"paisBacen":{"maximum":999999,"type":"integer","description":"Código do Pais/Bacen da Transportadora"},"codRUC":{"maximum":99999999999,"type":"integer","description":"Código RUC da Transportadora"},"emailNfe":{"maxLength":60,"type":"string","description":"E-mail da Nota Fiscal Eletrônica da Transportadora"},"numero":{"maxLength":10,"type":"string","description":"Número do Endereço da Transportadora"},"rntrc":{"maxLength":14,"type":"string","description":"Registro Nacional de Transportador da Transportadora"},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}},"DadosCustomizados":{"required":["campo","valor"],"type":"object","properties":{"campo":{"type":"string"},"valor":{"type":"string"}}},"Erro":{"type":"object","properties":{"mensagem":{"type":"string"}}}}},"paths":{"/transportadora/{id}":{"get":{"tags":["Transportadora"],"summary":"Obter uma Transportadora","operationId":"ObterTransportadora","parameters":[{"name":"empresa","in":"header","description":"Código da Empresa","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","description":"Código da Transportadora","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transportadora"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Erro"}}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}}}
```

## PUT /transportadora/{id}

> Atualizar uma Transportadora

```json
{"openapi":"3.0.1","info":{"title":"Cadastros Gerais","version":"1.0"},"tags":[{"name":"Transportadora","description":"transportadora"}],"servers":[{"url":"https://localhost/cadastrosgerais/v10"},{"url":"http://localhost/cadastrosgerais/v10"}],"security":[{"csw_auth":[]}],"components":{"securitySchemes":{"csw_auth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"TransportadoraPut":{"type":"object","properties":{"codEmpresa":{"type":"integer","description":"Código da Empresa da Transportadora"},"codTransportadora":{"type":"integer","description":"Código da Transportadora"},"nome":{"maxLength":60,"type":"string","description":"Nome da Transportadora"},"endereco":{"maxLength":60,"type":"string","description":"Endereço da Transportadora"},"cep":{"maxLength":8,"type":"string","description":"Código do CEP da Transportadora (sem formatação)"},"cpfCnpj":{"type":"string","description":"Código do CPF ou CNPJ da Transportadora (sem formatação)"},"nomeFantasia":{"maxLength":30,"type":"string","description":"Nome Fantasia da Transportadora"},"inscEstadual":{"maxLength":15,"type":"string","description":"Inscrição Estadual da Transportadora (sem formatação)"},"situacao":{"type":"integer","description":"Situação da Transportadora (0-Inativo, 1-Ativo)","enum":[0,1]},"telefone":{"maxLength":15,"type":"string","description":"Telefone da Transportadora"},"teleFax":{"maxLength":15,"type":"string","description":"Telefone/Fax da Transportadora"},"bairro":{"maxLength":30,"type":"string","description":"Bairro da Transportadora"},"contato":{"maxLength":30,"type":"string","description":"Contato da Transportadora"},"email":{"maxLength":60,"type":"string","description":"E-mail da Transportadora"},"obsNotaFiscal":{"type":"integer","description":"Código da Observação para a Nota Fiscal"},"tipo":{"type":"integer","description":"Tipo da Transportadora (1-Transportadora, 2-Consignatário)","enum":[1,2]},"dataValidadeSeguro":{"type":"string","description":"Data de Validade do Seguro da Transportadora (YYYY-MM-DD)","format":"date"},"paisCidadeExterior":{"type":"string","description":"País e Cidade do Exterior da Transportadora"},"paisBacen":{"maximum":999999,"type":"integer","description":"Código do Pais/Bacen da Transportadora"},"codRUC":{"maximum":99999999999,"type":"integer","description":"Código RUC da Transportadora"},"emailNfe":{"maxLength":60,"type":"string","description":"E-mail da Nota Fiscal Eletrônica da Transportadora"},"numero":{"maxLength":10,"type":"string","description":"Número do Endereço da Transportadora"},"rntrc":{"maxLength":14,"type":"string","description":"Registro Nacional de Transportador da Transportadora"},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}},"DadosCustomizados":{"required":["campo","valor"],"type":"object","properties":{"campo":{"type":"string"},"valor":{"type":"string"}}},"Transportadora":{"type":"object","properties":{"codEmpresa":{"type":"integer","description":"Código da Empresa da Transportadora"},"codTransportadora":{"type":"integer","description":"Código da Transportadora"},"nome":{"maxLength":60,"type":"string","description":"Nome da Transportadora"},"endereco":{"maxLength":60,"type":"string","description":"Endereço da Transportadora"},"cep":{"maxLength":8,"type":"string","description":"Código do CEP da Transportadora"},"cpfCnpj":{"type":"string","description":"Código do CPF ou CNPJ da Transportadora"},"nomeFantasia":{"maxLength":30,"type":"string","description":"Nome Fantasia da Transportadora"},"inscEstadual":{"maxLength":15,"type":"string","description":"Inscrição Estadual da Transportadora"},"situacao":{"type":"integer","description":"Situação da Transportadora (0-Inativo, 1-Ativo)","enum":[0,1]},"telefone":{"maxLength":15,"type":"string","description":"Telefone da Transportadora"},"teleFax":{"maxLength":15,"type":"string","description":"Telefone/Fax da Transportadora"},"bairro":{"maxLength":30,"type":"string","description":"Bairro da Transportadora"},"contato":{"maxLength":30,"type":"string","description":"Contato da Transportadora"},"email":{"maxLength":60,"type":"string","description":"E-mail da Transportadora"},"obsNotaFiscal":{"type":"integer","description":"Código da Observação para a Nota Fiscal"},"tipo":{"type":"integer","description":"Tipo da Transportadora (1-Transportadora, 2-Consignatário)","enum":[1,2]},"dataValidadeSeguro":{"type":"string","description":"Data de Validade do Seguro da Transportadora"},"paisCidadeExterior":{"type":"string","description":"País e Cidade do Exterior da Transportadora"},"paisBacen":{"maximum":999999,"type":"integer","description":"Código do Pais/Bacen da Transportadora"},"codRUC":{"maximum":99999999999,"type":"integer","description":"Código RUC da Transportadora"},"emailNfe":{"maxLength":60,"type":"string","description":"E-mail da Nota Fiscal Eletrônica da Transportadora"},"numero":{"maxLength":10,"type":"string","description":"Número do Endereço da Transportadora"},"rntrc":{"maxLength":14,"type":"string","description":"Registro Nacional de Transportador da Transportadora"},"dadosCustomizados":{"type":"array","items":{"$ref":"#/components/schemas/DadosCustomizados"}}}},"Erro":{"type":"object","properties":{"mensagem":{"type":"string"}}}}},"paths":{"/transportadora/{id}":{"put":{"tags":["Transportadora"],"summary":"Atualizar uma Transportadora","operationId":"AtualizarTransportadora","parameters":[{"name":"empresa","in":"header","description":"Código da Empresa","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","description":"Código da Transportadora","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Dados da Transportadora","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransportadoraPut"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transportadora"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Erro"}}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}}}
```

## DELETE /transportadora/{id}

> Excluir uma Transportadora

```json
{"openapi":"3.0.1","info":{"title":"Cadastros Gerais","version":"1.0"},"tags":[{"name":"Transportadora","description":"transportadora"}],"servers":[{"url":"https://localhost/cadastrosgerais/v10"},{"url":"http://localhost/cadastrosgerais/v10"}],"security":[{"csw_auth":[]}],"components":{"securitySchemes":{"csw_auth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"Erro":{"type":"object","properties":{"mensagem":{"type":"string"}}}}},"paths":{"/transportadora/{id}":{"delete":{"tags":["Transportadora"],"summary":"Excluir uma Transportadora","operationId":"ExcluirTransportadora","parameters":[{"name":"empresa","in":"header","description":"Código da Empresa","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","description":"Código da Transportadora","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Erro"}}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.consistem.com.br/consistem-api/consistem-erp-api/comercial/cadastros-gerais-v1.0/transportadora.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.