Pedido Compra - inncash/inncash-docs GitHub Wiki

Introdução

Web service responsável pelas as operações relacionadas a pedido compra. 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/purchase-orders

Corpo da requisição :

{	
    "refresh_all": false,
    "data": [
        {
             "id": "3B18FBC187D8E7978C8510BF894C0FE0",
             "number": "445727",
             "supplier_code": "74547853",
             "store_code": "0001",
             "item": "0001",
             "product_code": "374",
             "product_description": "Nihil necessitatibus autem iure omnis sapiente nisi asperiores commodi.",
             "primary_unit_measurement": "UN",
             "secondary_unit_measurement": null,
             "quantity": "1042.86059249",
             "quantity_delivered": "275742026.97969",
             "quantity_sort": "2273",
             "price": "53768.999877",
             "total": "34.424340911",
             "type": "000",
             "price_list": null,
             "purchase_request_number": null,
             "purchase_request_item": null,
             "storage": "SE",
             "emission_date": "1976-10-28",
             "delivery_date": "2007-02-16",
             "observation": null,
             "payment_method": "00",
             "branch_delivery": "010101",
             "eliminated_by_waste": null
        }
    ]
}

Campos

Tipo Nome Descrição Obrigatório Tamanho
String id Identificador único do registro. X 254
String number Informe o número do pedido de compra/autorização de entrega. X 6
String supplier_code Informe o código do fornecedor do material. X 20
String store_code Informe a loja do fornecedor do material. X 4
String item Número sequêncial do ítem do pedido de compra/autorização de entrega. X 4
String product_code Informe o código do produto deste pedido de compra/autorização de entrega. X 20
String product_description Informe a descrição do produto. X 245
String primary_unit_measurement Primeira unidade de medida. X 6
String secondary_unit_measurement Segunda unidade de medida do produto. 6
Float quantity Informe a quantidade do material solicitada para o fornecedor deste pedido de compra/autorização de entrega. X decimal(15, 5)
Float quantity_delivered Quantidade já entregue do material. X decimal(15, 5)
Float quantity_sort Quantidade de material em processo de recebimento. Esta informação somente é utilizada quanto utiliza-se a rotina de recebimento de material (MATA140). X decimal(15, 5)
Float price Preço unitário bruto do item do pedido de compra/autorização de entrega. X decimal(18, 7)
Float total Informe o resultado do produto da quantidade sobre o preço unitário. X decimal(15, 5)
String type Informe o tipo de entrada e saída deste item do pedido de compra/autorização de entrega. X 3
String price_list Tabela de preço. 3
String purchase_request_number Informe o número da solicitação de compra que originou este pedido de compra. 6
String purchase_request_item Informe o item da solicitação de compras vinculada a este pedido de compra. 4
String storage Informe o armazém a ser utilizado para armazenagem do material. X 2
Date emission_date Data de emissão do pedido de compras/autorização de entrega. X
Date delivery_date Data prevista para a entrega do material solicitado. Esta data informa para o sistema quando o material estará disponível para utilização. X
String observation Observaçöes a serem impressas no pedido de compra/autorização de entrega. 250
String payment_method Código da condição de pagamento deste pedido de compra/autorização de entrega. X 3
String branch_delivery Código da filial para entrega do pedido de compras/autorização de entrega. X 6
String eliminated_by_waste Informa se o pedido de compra/ autorização de entrega foi eliminada por resíduo. 1

Delete: URL_BASE/purchase-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** ⚠️