Skip to content

Homologação

bling_erp_api.resources.homologation.HomologationResource 

HomologationResource(transport: Transport)

Bases: BaseResource

Operações de homologação do Bling.

Este recurso mapeia os endpoints /homologacao/produtos. Os métodos canônicos usam português para acompanhar a documentação oficial. Aliases em inglês estão 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

obter 

obter() -> HomologacaoProdutosGetResponse200

Obtém o produto da homologação.

Endpoint: GET /homologacao/produtos

Obtém o produto que será utilizado durante os demais passos da homologação, e inicia o processo de validação.

Returns:

Type Description
HomologacaoProdutosGetResponse200

Bling API response. Response schemas: 200: HomologacaoDadosBaseDTO
Source code in src/bling_erp_api/resources/homologation.py 
28
29
30
31
32
33
34
35
36
37
38
39
40
def obter(self) -> HomologacaoProdutosGetResponse200:
    """Obtém o produto da homologação.

    Endpoint: GET /homologacao/produtos

    Obtém o produto que será utilizado durante os demais passos da homologação, e
    inicia o processo de validação.

    Returns:
        Bling API response. Response schemas: 200: HomologacaoDadosBaseDTO
    """
    raw = self._get("/homologacao/produtos")
    return self._validate_response(HomologacaoProdutosGetResponse200, raw)

criar 

criar(dados: JsonObject) -> HomologacaoProdutosPostResponse201

Cria o produto da homologação.

Endpoint: POST /homologacao/produtos

Cria o produto da homologação.

Parameters:

Name Type Description Default
dados JsonObject

Dados do produto da homologação (Bling: request body)

 required

Returns:

Type Description
HomologacaoProdutosPostResponse201

Bling API response. Response schemas: 201: HomologacaoDadosBaseDTO, HomologacaoDadosDTO; 400: ErrorResponse
Source code in src/bling_erp_api/resources/homologation.py 
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
def criar(self, dados: JsonObject) -> HomologacaoProdutosPostResponse201:
    """Cria o produto da homologação.

    Endpoint: POST /homologacao/produtos

    Cria o produto da homologação.

    Args:
        dados: Dados do produto da homologação (Bling: request body)

    Returns:
        Bling API response. Response schemas: 201: HomologacaoDadosBaseDTO, HomologacaoDadosDTO; 400: ErrorResponse
    """
    raw = self._post(
        "/homologacao/produtos",
        json=to_json_object(dados),
        headers=_HOMOLOGACAO_HEADER,
    )
    return self._validate_response(HomologacaoProdutosPostResponse201, raw)

alterar 

alterar(id_produto_homologacao: int, dados: JsonObject) -> JsonObject

Altera o produto da homologação.

Endpoint: PUT /homologacao/produtos/{idProdutoHomologacao}

Altera o produto da homologação pelo ID.

Parameters:

Name Type Description Default
id_produto_homologacao int

ID do produto da homologação (Bling: idProdutoHomologacao, integer, obrigatório)

 required
dados JsonObject

Dados do produto da homologação (Bling: request body)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 400: ErrorResponse
Source code in src/bling_erp_api/resources/homologation.py 
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
def alterar(self, id_produto_homologacao: int, dados: JsonObject) -> JsonObject:
    """Altera o produto da homologação.

    Endpoint: PUT /homologacao/produtos/{idProdutoHomologacao}

    Altera o produto da homologação pelo ID.

    Args:
        id_produto_homologacao: ID do produto da homologação (Bling: ``idProdutoHomologacao``, integer, obrigatório)
        dados: Dados do produto da homologação (Bling: request body)

    Returns:
        Bling API response. Response schemas: 400: ErrorResponse
    """
    return self._put(
        f"/homologacao/produtos/{id_produto_homologacao}",
        json=to_json_object(dados),
        headers=_HOMOLOGACAO_HEADER,
    )

remover 

remover(id_produto_homologacao: int) -> JsonObject

Remove o produto da homologação.

Endpoint: DELETE /homologacao/produtos/{idProdutoHomologacao}

Remove o produto da homologação pelo ID.

Parameters:

Name Type Description Default
id_produto_homologacao int

ID do produto da homologação (Bling: idProdutoHomologacao, integer, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 400: ErrorResponse
Source code in src/bling_erp_api/resources/homologation.py 
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
def remover(self, id_produto_homologacao: int) -> JsonObject:
    """Remove o produto da homologação.

    Endpoint: DELETE /homologacao/produtos/{idProdutoHomologacao}

    Remove o produto da homologação pelo ID.

    Args:
        id_produto_homologacao: ID do produto da homologação (Bling: ``idProdutoHomologacao``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 400: ErrorResponse
    """
    return self._delete(
        f"/homologacao/produtos/{id_produto_homologacao}",
        headers=_HOMOLOGACAO_HEADER,
    )

alterar_situacao 

alterar_situacao(id_produto_homologacao: int, situacao: str) -> JsonObject

Altera a situação do produto da homologação.

Endpoint: PATCH /homologacao/produtos/{idProdutoHomologacao}/situacoes

Altera a situação do produto da homologação pelo ID.

Parameters:

Name Type Description Default
id_produto_homologacao int

ID do produto da homologação (Bling: idProdutoHomologacao, integer, obrigatório)

 required
situacao str

Nova situação (Bling: situacao, string, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 400: ErrorResponse
Source code in src/bling_erp_api/resources/homologation.py 
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
def alterar_situacao(self, id_produto_homologacao: int, situacao: str) -> JsonObject:
    """Altera a situação do produto da homologação.

    Endpoint: PATCH /homologacao/produtos/{idProdutoHomologacao}/situacoes

    Altera a situação do produto da homologação pelo ID.

    Args:
        id_produto_homologacao: ID do produto da homologação (Bling: ``idProdutoHomologacao``, integer, obrigatório)
        situacao: Nova situação (Bling: situacao, string, obrigatório)

    Returns:
        Bling API response. Response schemas: 400: ErrorResponse
    """
    return self._patch(
        f"/homologacao/produtos/{id_produto_homologacao}/situacoes",
        json=to_json_object({"situacao": situacao}),
        headers=_HOMOLOGACAO_HEADER,
    )