-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #3 from sthima/update-doc
Initial documentation
- Loading branch information
Showing
2 changed files
with
86 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,85 @@ | ||
# Bling | ||
|
||
--- | ||
|
||
Integração para utilização do sistema de [Bling](https://www.bling.com.br/home) através das [APIs](https://manuais.bling.com.br/manual/?categoria=api-v2&tipo=api). O sistema Bling disponibiliza diversos módulos, a integração porém ainda não está finalizada e deve ser incrementada a medida que os módulos forem necessários. | ||
|
||
## Módulos: | ||
|
||
- Borderos | ||
- Campos customizados | ||
- Categoria | ||
- Categorias loja | ||
- Contas a pagar | ||
- Contatos | ||
- Contrato | ||
- CTe | ||
- Depósitos | ||
- Estoques | ||
- Formas de pagamento | ||
- Grupos de produtos | ||
- Logística | ||
- NFCe | ||
- Notas fiscais | ||
- Notas serviços | ||
- Pedidos | ||
- Pedidos de compra | ||
- Produto loja | ||
- Produtos | ||
- Produtos fornecedores | ||
- Proposta comercial | ||
- Situações | ||
|
||
## Instalação | ||
|
||
**Yarn:** | ||
|
||
```bash | ||
yarn add @sthima/bling | ||
``` | ||
|
||
**NPM:** | ||
|
||
``` | ||
npm install --save @sthima/bling | ||
``` | ||
|
||
## Utilização | ||
|
||
Esta biblioteca fornece como inteface única um cliente, através dos quais todos os métodos disponíveis, e já implementados, podem ser utilizado. Para começar sua utilização, a primeira coisa que deve ser realizada é a criação de um novo cliente, conforme o exemplo: | ||
|
||
```javascript | ||
import { BlingClient } from '@sthima/bling | ||
const client = new BlingClient('chave de acesso') | ||
``` | ||
## Notas Fiscais | ||
### Listar todas as notas fiscais | ||
```javascript | ||
const nfs = await client.listarNotasFiscais(); | ||
``` | ||
É possível filtrar quais notas devem ser retornadas através de um objeto filtro no seguinte formato: | ||
```javascript | ||
{ | ||
"dataEmissao"?: [Date, Date] | [Date], | ||
"situacao"?: number, | ||
"tipo"?: string, | ||
} | ||
``` | ||
Os valores possíveis de `situacao` e `tipo` podem ser encotradas na [documentação oficial](https://manuais.bling.com.br/manual/?item=notas-fiscais). Mas para facilitar, o campo `situacao` foi mapeado através de uma `enum` acessível através de: | ||
```javascript | ||
import { SituacaoNF } from '@sthima/bling | ||
``` | ||
|
||
### Buscar uma única nota fiscal | ||
|
||
```javascript | ||
const nf = await client.buscarNotaFiscal(numero, serie); | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1,2 @@ | ||
export { BlingClient } from './bling'; | ||
export { SituacaoNF } from './types'; |