Pedido Compra - inncash/inncash-docs GitHub Wiki
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:
- 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: []
- 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.
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
        }
    ]
}| 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
| 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 |