Início > Integração
Versão: 2.0
Custo produtos
Última Atualização: 19/11/2024
Esta Integração permite o gerenciamento dos custos de produtos.
Sintaxe da Requisição
Para que a requisição do método Post seja bem-sucedida, é necessário que
seja enviado os seguintes valores dentro de uma lista de JSON:
Elementos da Requisição
data_movimentacao *
Data da movimentação.
Tipo: Date.
ean_ou_dun *
Código EAN ou DUN.
Tipo: Number.
cod_interno
Código Produto Interno
Tipo: Number.
operacao *
Tipo de Operação.
Tipo: String.
quantidade *
Quantidade embalagem.
Tipo: Float.
preco_unitario *
Preço Unitário
Tipo: Float.
preco_tabela *
Preço Tabela.
Obs: Obrigatório ou valor zero.
Tipo: Float.
custo_financeiro *
Custo Financeiro.
Obs: Obrigatório ou valor zero.
Tipo: Float.
custo_contabil *
Custo Contábil.
Obs: Obrigatório ou valor zero.
Tipo: Float.
custo_real *
Custo Real.
Obs: Obrigatório ou valor zero.
Tipo: Float.
valor_frete *
Valor do Frete.
Obs: Obrigatório ou valor zero.
Tipo: Float.
numero_pedido
Número do pedido, entrada ou saída.
Tipo: Integer.
numero_carregamento
Número do carregamento das saídas.
Tipo: Integer.
custo_real_st *
Custo efetivo de um produto sem considerar a Substituição Tributária (ST).
Obs: Obrigatório ou valor zero.
Tipo: Float.
quantidade_contabil
Quantidade contábil na movimentação.
Tipo: Integer.
Caso ocorra tudo certo com a requisição e retorne o status code 200, essa será a resposta que você receberá:
Sintaxe da Resposta
Elementos da Resposta
message
Mensagem de retorno.
Tipo: String.
Caso seja enviado dois ou mais custos de produtos, e pelo menos um tenha erro e um tenha exito, as movimentações inválidas são retornadas com detalhes dos erros.
207 Multi-status
Elementos da Resposta
message
Mensagem de retorno.
Tipo: String.
totalValidas
Total de movimentações válidas
Tipo: Integer.
totalInvalidas
Total de movimentações inválidas
Tipo: Integer.
invalidas
Operações que foram inválidas.
Tipo: String.
data_movimentacao
Data da movimentação.
Tipo: Date.
ean_ou_dun
Código EAN ou DUN.
Tipo: Number.
cod_interno
Código Produto Interno
Tipo: Number.
operacao
Tipo de Operação.
Tipo: String.
quantidade
Quantidade embalagem.
Tipo: Float.
preco_unitario
Preço Unitário
Tipo: Float.
preco_tabela
Tipo: Float.
Preço Tabela.
custo_financeiro
Tipo: Float.
Custo Financeiro.
custo_contabil
Custo Contábil.
Tipo: Float.
custo_real
Custo Real.
Tipo: Float.
valor_frete
Valor do Frete.
Tipo: Float.
numero_pedido
Número do pedido, entrada ou saída.
Tipo: Integer.
numero_carregamento
Número do carregamento das saídas.
Tipo: Integer.
custo_real_st
Custo efetivo de um produto sem considerar a Substituição Tributária (ST).
Obs: Obrigatório ou valor zero.
Tipo: Float.
quantidade_contabil
Quantidade contábil na movimentação.
Tipo: Integer.
erros
Lista de erros que ocorreram na request.
Tipo: Lista de JSON.
campo
Campo onde o erro está incorreto.
Tipo: String.
erro
Mensagem com informações do erro.
Tipo: String.
Respostas para erros
Caso ocorra algum erro durante a requisição, os possíveis erros são:
400 Bad Request
Caso o corpo da requisição contenha campos inválidas. O array invalidas conterá os detalhes e os erros encontrados.
(O payload de retorno terá os mesmos campos do status 207).
500 Internal Server Error
POST Custo produtos
Última Atualização: 27/11/2024
Enpoint utilizado para adicionar custo aos produtos.