Skip to content

Fornecedores de Produtos

bling_erp_api.resources.product_suppliers.ProductSuppliersResource 

ProductSuppliersResource(transport: Transport)

Bases: BaseResource

Resource para fornecedores de produtos do Bling.

Mapeia os endpoints /produtos/fornecedores para listagem, consulta, criação, alteração e remoção de vínculos de produtos com fornecedores. Métodos canônicos em pt-BR; aliases em inglês disponíveis para compatibilidade.

Source code in src/bling_erp_api/resources/base.py 
141
142
143
def __init__(self, transport: Transport) -> None:
    """Create a resource bound to a transport."""
    self._transport = transport

listar 

listar(
    *,
    pagina: int = 1,
    limite: int = 100,
    id_produto: int | None = None,
    id_fornecedor: int | None = None,
) -> ProdutosFornecedoresGetResponse200

Obtém produtos fornecedores.

Endpoint: GET /produtos/fornecedores

Obtém produtos fornecedores paginados.

Parameters:

Name Type Description Default
pagina int

N° da página da listagem (Bling: pagina, integer, opcional)

 1
limite int

Quantidade de registros que devem ser exibidos por página (Bling: limite, integer, opcional)

 100
id_produto int | None

ID do produto (Bling: idProduto, integer, opcional)

 None
id_fornecedor int | None

ID do contato do tipo fornecedor (Bling: idFornecedor, integer, opcional)

 None

Returns:

Type Description
ProdutosFornecedoresGetResponse200

Bling API response. Response schemas: 200: ProdutosFornecedoresDadosBaseDTO
Source code in src/bling_erp_api/resources/product_suppliers.py 
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
def listar(
    self,
    *,
    pagina: int = 1,
    limite: int = 100,
    id_produto: int | None = None,
    id_fornecedor: int | None = None,
) -> ProdutosFornecedoresGetResponse200:
    """Obtém produtos fornecedores.

    Endpoint: GET /produtos/fornecedores

    Obtém produtos fornecedores paginados.

    Args:
        pagina: N° da página da listagem (Bling: ``pagina``, integer, opcional)
        limite: Quantidade de registros que devem ser exibidos por página (Bling: ``limite``, integer, opcional)
        id_produto: ID do produto (Bling: ``idProduto``, integer, opcional)
        id_fornecedor: ID do contato do tipo fornecedor (Bling: ``idFornecedor``, integer, opcional)

    Returns:
        Bling API response. Response schemas: 200: ProdutosFornecedoresDadosBaseDTO
    """
    raw = self._get(
        "/produtos/fornecedores",
        params=_supplier_list_params(
            pagina=pagina,
            limite=limite,
            id_produto=id_produto,
            id_fornecedor=id_fornecedor,
        ),
    )
    return self._validate_response(ProdutosFornecedoresGetResponse200, raw)

obter 

obter(
    id_produto_fornecedor: int,
) -> ProdutosFornecedoresIdProdutoFornecedorGetResponse200

Obtém um produto fornecedor.

Endpoint: GET /produtos/fornecedores/{idProdutoFornecedor}

Obtém um produto fornecedor pelo ID.

Parameters:

Name Type Description Default
id_produto_fornecedor int

ID do produto fornecedor (Bling: idProdutoFornecedor, integer, obrigatório)

 required

Returns:

Type Description
ProdutosFornecedoresIdProdutoFornecedorGetResponse200

Bling API response. Response schemas: 200: ProdutosFornecedoresDadosBaseDTO, ProdutosFornecedoresDadosDTO; 404: ErrorResponse
Source code in src/bling_erp_api/resources/product_suppliers.py 
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
def obter(
    self, id_produto_fornecedor: int
) -> ProdutosFornecedoresIdProdutoFornecedorGetResponse200:
    """Obtém um produto fornecedor.

    Endpoint: GET /produtos/fornecedores/{idProdutoFornecedor}

    Obtém um produto fornecedor pelo ID.

    Args:
        id_produto_fornecedor: ID do produto fornecedor (Bling: ``idProdutoFornecedor``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 200: ProdutosFornecedoresDadosBaseDTO, ProdutosFornecedoresDadosDTO; 404: ErrorResponse
    """
    raw = self._get(f"/produtos/fornecedores/{id_produto_fornecedor}")
    return self._validate_response(ProdutosFornecedoresIdProdutoFornecedorGetResponse200, raw)

criar 

criar(
    dados: ProdutosFornecedoresPostRequest,
) -> ProdutosFornecedoresPostResponse201

Cria um produto fornecedor.

Endpoint: POST /produtos/fornecedores

Cria um produto fornecedor.

Parameters:

Name Type Description Default
dados ProdutosFornecedoresPostRequest

Dados do produto fornecedor (Bling: ProdutosFornecedoresDadosBaseDTO, ProdutosFornecedoresDadosDTO, obrigatório)

 required

Request body schema: ProdutosFornecedoresDadosBaseDTO, ProdutosFornecedoresDadosDTO

Returns:

Type Description
ProdutosFornecedoresPostResponse201

Bling API response. Response schemas: 201: BasePostResponse; 400: ErrorResponse
Source code in src/bling_erp_api/resources/product_suppliers.py 
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
def criar(self, dados: ProdutosFornecedoresPostRequest) -> ProdutosFornecedoresPostResponse201:
    """Cria um produto fornecedor.

    Endpoint: POST /produtos/fornecedores

    Cria um produto fornecedor.

    Args:
        dados: Dados do produto fornecedor (Bling: ``ProdutosFornecedoresDadosBaseDTO, ProdutosFornecedoresDadosDTO``, obrigatório)

    Request body schema: ProdutosFornecedoresDadosBaseDTO, ProdutosFornecedoresDadosDTO

    Returns:
        Bling API response. Response schemas: 201: BasePostResponse; 400: ErrorResponse
    """
    raw = self._post("/produtos/fornecedores", json=to_json_object(dados))
    return self._validate_response(ProdutosFornecedoresPostResponse201, raw)

alterar 

alterar(
    id_produto_fornecedor: int,
    dados: ProdutosFornecedoresIdProdutoFornecedorPutRequest,
) -> ProdutosFornecedoresIdProdutoFornecedorPutResponse200

Altera um produto fornecedor.

Endpoint: PUT /produtos/fornecedores/{idProdutoFornecedor}

Altera um produto fornecedor pelo ID.

Parameters:

Name Type Description Default
id_produto_fornecedor int

ID do produto fornecedor (Bling: idProdutoFornecedor, integer, obrigatório)

 required
dados ProdutosFornecedoresIdProdutoFornecedorPutRequest

Dados do produto fornecedor (Bling: ProdutosFornecedoresIdProdutoFornecedorPutRequest, object, obrigatório)

 required

Request body schema: ProdutosFornecedoresDadosBaseUpdateDTO, ProdutosFornecedoresDadosUpdateDTO

Returns:

Type Description
ProdutosFornecedoresIdProdutoFornecedorPutResponse200

Bling API response. Response schemas: 200: BasePostResponse; 400: ErrorResponse; 404: ErrorResponse
Source code in src/bling_erp_api/resources/product_suppliers.py 
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
def alterar(
    self,
    id_produto_fornecedor: int,
    dados: ProdutosFornecedoresIdProdutoFornecedorPutRequest,
) -> ProdutosFornecedoresIdProdutoFornecedorPutResponse200:
    """Altera um produto fornecedor.

    Endpoint: PUT /produtos/fornecedores/{idProdutoFornecedor}

    Altera um produto fornecedor pelo ID.

    Args:
        id_produto_fornecedor: ID do produto fornecedor (Bling: ``idProdutoFornecedor``, integer, obrigatório)
        dados: Dados do produto fornecedor (Bling: ``ProdutosFornecedoresIdProdutoFornecedorPutRequest``, object, obrigatório)

    Request body schema: ProdutosFornecedoresDadosBaseUpdateDTO, ProdutosFornecedoresDadosUpdateDTO

    Returns:
        Bling API response. Response schemas: 200: BasePostResponse; 400: ErrorResponse; 404: ErrorResponse
    """
    raw = self._put(
        f"/produtos/fornecedores/{id_produto_fornecedor}",
        json=to_json_object(dados),
    )
    return self._validate_response(ProdutosFornecedoresIdProdutoFornecedorPutResponse200, raw)

remover 

remover(id_produto_fornecedor: int) -> JsonObject

Remove um produto fornecedor.

Endpoint: DELETE /produtos/fornecedores/{idProdutoFornecedor}

Remove um produto fornecedor pelo ID.

Parameters:

Name Type Description Default
id_produto_fornecedor int

ID do produto fornecedor (Bling: idProdutoFornecedor, integer, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 400: ErrorResponse; 404: ErrorResponse
Source code in src/bling_erp_api/resources/product_suppliers.py 
154
155
156
157
158
159
160
161
162
163
164
165
166
167
def remover(self, id_produto_fornecedor: int) -> JsonObject:
    """Remove um produto fornecedor.

    Endpoint: DELETE /produtos/fornecedores/{idProdutoFornecedor}

    Remove um produto fornecedor pelo ID.

    Args:
        id_produto_fornecedor: ID do produto fornecedor (Bling: ``idProdutoFornecedor``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 400: ErrorResponse; 404: ErrorResponse
    """
    return self._delete(f"/produtos/fornecedores/{id_produto_fornecedor}")