Pedido Venda - inncash/inncash-docs GitHub Wiki

Introdução

Web service responsável pelas as operações relacionadas a pedido venda. Existem dois endereços nesse web service, um sendo referente atualização/criação de dados, e outro referente a exclusão. Pontos de atenção:

  1. Nas requisições será necessário especificar o identificador da empresa por meio do "company_id" (fornecido pela Innova no momento de implantação). Ele deverá ser enviado no header da requisição com esse formato: Company-Ids: []
  2. O campo "refresh_all" quando ativo irá excluir todos os registros da tabela para a empresa específica e importar novamente do zero. Essa opção deve ser utilizada no momento de implantação para testes, não é recomendável utilizar em produção.

Requisições

Post: URL_BASE/sale-orders

Corpo da requisição :

{	
    "refresh_all": false,
    "data": [
        {
             "id": "3B18FBC187D8E7978C8510BF894C0FE0",
             "number": "340351774",
             "type": "C",
             "customer_code": "Bergnaum, Nader and",
             "store_code": "0001",
             "delivery_customer_code": "Lueilwitz Inc",
             "delivery_customer_store": "Gottl",
             "carrier_code": "Grady, Doo",
             "payment_terms_code": "000",
             "price_list_code": "table",
             "total": "220486.39998695",
             "icms_value": "2",
             "st_value": "3041.3",
             "seller_code": "2876131707",
             "bank_code": "001",
             "emission_date": "1999-07-27",
             "expense_amount": "7.617241774",
             "currency": "1",
             "shipping_type": "R",
             "shipping_value": "7057.9",
             "invoice_number": "745563562",
             "invoice_serie": "000",
             "region": null,
             "sector": null,
             "order_origin": "C",
             "hour": null,
             "order_sales_department": null
        }
    ]
}

Campos

Tipo Nome Descrição Obrigatório Tamanho
String id Identificador único do registro. X 254
String number Número do pedido de venda. X 2
String type Tipo de pedido. X 1
String customer_code Código identificador do cliente ou fornecedor, dependendo do tipo. X 20
String store_code Código identificador da loja. X 5
String delivery_customer_code Código do cliente de entrega. X 20
String delivery_customer_store Loja do cliente de entrega. X 5
String carrier_code Código de identificação da transportadora. X 10
String payment_terms_code Código da condição de pagamento. X 10
String price_list_code Tabela padrão do preço de venda do cadastro de produtos para o cliente. X 10
Float total Valor total do pedido de venda. X
Float icms_value Valor do ICMS retido. X
Float st_value Valor da ST. X
String seller_code Código do vendedor. X 10
String bank_code Código do banco no qual o título é negociado. X 10
Date emission_date Data da emissão do pedido de venda. X
Float expense_amount Valor da despesa destacado no total da nota fiscal. X
Int currency Moeda em que o pedido de venda está sendo digitada. X
String shipping_type Tipo do frete. X 1
Float shipping_value Valor do frete destacado do total da nota fiscal. X
String invoice_number Número da nota fiscal. X 20
String invoice_serie Série da nota fiscal. X 3
String region Região do pedido. 10
String sector Distrito de vendas do pedido. 10
String order_origin Origem do pedido. X 45
String hour Hora do pedido. 10
String order_sales_department Setor de vendas do pedido. 10

Delete: URL_BASE/sale-orders/{id}

O "id" é o campo que identificador que que define o registro

Resposta HTTP

Código Mensagem Descrição
200 Operação realizada com sucesso
422 Data invalid Ocorre quando alguma informação obrigatória deixa de ser enviada
404 Configurações de empresa necessárias não encontradas Dentro do Inncash, a configuração para essa tabela não foi encontrada, entre em contato com o administrador do sistema.
500 Erro interno do servidor Erro interno no servidor
⚠️ **GitHub.com Fallback** ⚠️