API para Cotação de Faltas

Nossa API troca informações através de JSON. Para aprender mais visite http://www.w3schools.com/json/ e http://json.org. Além disso, utiliza REST para a comunicação. Para aprender mais visite http://www.infoq.com/br/articles/rest-introduction.

O uso e acesso à API está expressamente condicionada à sua conformidade com as políticas, restrições e outras disposições relacionadas com a API estabelecido em nossas restrições de API e Responsabilidades. Você também deve estar de acordo com as restrições estabelecidas nos Termos de Serviço da Bluesoft e a Política de Privacidade, em todas as utilizações da API. Podemos cortar o acesso caso entendermos que você não esteja a utilizando de maneira correta.

Com a API você poderá:

• Buscar informação de cotações criadas
• Buscar itens da cotação
• Enviar preços para os itens da cotação
• Buscar pedidos de compras
• Consultar status da cotação

 

Como Acessar a API

Para acessar a API, é preciso que o cliente inclua no header de cada requisição HTTP o seu token de autenticação.

Por exemplo:

Para gerar este access_token, o representante deverá acessar seu cadastro no Bluesoft ERP e navegar até a aba Cotação de Faltas API. Cada representante deverá gerar o seu próprio access_token, pois os dados retornados pela API serão baseados nas informações cadastradas no ERP.

 

Buscar as Cotações em Aberto

Parâmetros:

 

URL

Formato da URL:

URL de exemplo:

 

Retorno

 

Exemplos

Sem Cotação:

Com 4 cotações

Cotacoes:

[
  {"cotacaoKey" : 1020300},
  {"cotacaoKey" : 2234234},
  {"cotacaoKey" : 345435},
  {"cotacaoKey" : 3453534}
]

 

 

Itens de uma Cotação

Parâmetros:

URL

Formato da URL:

URL exemplo:

 

Retorno

 

Exemplos

Retorno 1: GTIN, Produto e o código do fornecedor

 

{
  "cotacaoKey": 1020300,
  "produtos": [
    {"gtin": 7898422746810, "descricao": "Sabonte Firming 90gr", "codigoProdutoFornecedor": "0183751"},
    {"gtin": 7898422746100, "descricao": "Sabonte Regular 90gr", "codigoProdutoFornecedor": "0183700"},
    {"gtin": 7898422746200, "descricao": "Sabonte Esfoliante 90gr", "codigoProdutoFornecedor": "0187880"},

  ]
}

{
  "cotacaoKey": 2234234,
  "produtos": [
    {"gtin": 7898746810000, "descricao": "Shampoo Cabelos Lisos 500ml", "codigoProdutoFornecedor": "0170051"},
    {"gtin": 7898446000100, "descricao": "Shampoo Cabelos Cacheado 500ml", "codigoProdutoFornecedor": "010088"},
    {"gtin": 7898200888811, "descricao": "Shampoo Cabelos Secos 500ml", "codigoProdutoFornecedor: "0199880"},

  ]
}

{
  "cotacaoKey": 345435,
  "produtos": []
}

 

 

 

Enviar Preços para Itens

Parâmetros:

 

URL

 

Formato do URL:

URL exemplo:

Retorno

 

 

Exemplo:

[
  {"gtin": 7898422746810, "preco": 1.99, "codigoProdutoFornecedor": "0183751"}, {"gtin": 7898422746100, "preco": 2.18, "codigoProdutoFornecedor": "0183700"}
]

http://erp.bluesoft.com.br/pb/api/cotacoes/2234234/atualizarPrecos

[
  {"gtin": 7898746810000, "preco": 7.89, "codigoProdutoFornecedor": "0170051"}, {"gtin": 7898446000100, "preco": 8.18, "codigoProdutoFornecedor": "010088"}
]

 

 

Tem Pedido pra Mim?

Parâmetros:

 

URL

Formato do URL:

URL exemplo:

 

Retorno

 

retornar pedidos, com itens (quantidades, descrição, custo)

 

Exemplo:

 

Retorno 2: Com Pedido

[
  { "pedidoMasterKey": 1234 
    {
      "pedidoKey": 23232, lojaKey: 1, entrega: 1,
      "itens": 
      [
        {"gtin": 7898422746810, "quantidade":2343, "preco": 1.99, "codigoProdutoFornecedor": "0183751"},
        {"gtin": 7898422746100, "quantidade":344, "preco": 2.18, "codigoProdutoFornecedor": "0183700"}
      ]
    }
  }
]

 

 

Consultar Status de uma Cotação

 

Parâmetros:

 

URL:

 

Formato do URL:

URL exemplo:

 

Retorno

 

Remessa:

 

Exemplo:

 

Retorno 1: Em aberto

{
  "codigo" : 0
  "status" : "aberto"
}

Retorno 2:

{
  "codigo" : 1
  "status" : "fechado"
}