Skip to content

Lançamentos de Lotes

bling_erp_api.resources.product_batch_entries.ProductBatchEntriesResource

ProductBatchEntriesResource(transport: Transport)

Bases: BaseResource

Resource para lançamentos e saldos de lotes de produtos do Bling.

Mapeia os endpoints de lançamentos sob /produtos/lotes/lancamentos e de saldos sob caminhos de lotes de produtos. 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
def __init__(self, transport: Transport) -> None:
    """Create a resource bound to a transport."""
    self._transport = transport

listar

listar(id_lote: int) -> ProdutosLotesIdLoteLancamentosGetResponse200

Obtém os lançamentos de um lote de produto.

Endpoint: GET /produtos/lotes/{idLote}/lancamentos

Obtém os lançamentos de um lote de produto pelo ID.

Parameters:

Name Type Description Default
id_lote int

ID do lote (Bling: idLote, integer, obrigatório)

required

Returns:

Type Description
ProdutosLotesIdLoteLancamentosGetResponse200

Bling API response. Response schemas: 200: LoteLancamentoDTO; 400: ErrorResponse; 404: ErrorResponse

Source code in src/bling_erp_api/resources/product_batch_entries.py
def listar(self, id_lote: int) -> ProdutosLotesIdLoteLancamentosGetResponse200:
    """Obtém os lançamentos de um lote de produto.

    Endpoint: GET /produtos/lotes/{idLote}/lancamentos

    Obtém os lançamentos de um lote de produto pelo ID.

    Args:
        id_lote: ID do lote (Bling: ``idLote``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 200: LoteLancamentoDTO; 400: ErrorResponse; 404: ErrorResponse
    """
    raw = self._get(f"/produtos/lotes/{id_lote}/lancamentos")
    return self._validate_response(ProdutosLotesIdLoteLancamentosGetResponse200, raw)

criar

criar(
    id_lote: int, dados: LoteLancamentoDTO
) -> ProdutosLotesIdLoteLancamentosPostResponse200

Cria um lançamento de um lote.

Endpoint: POST /produtos/lotes/{idLote}/lancamentos

Inclui lançamento de um lote.

Parameters:

Name Type Description Default
id_lote int

ID do lote (Bling: idLote, integer, obrigatório)

required
dados LoteLancamentoDTO

Dados do lançamento do lote (Bling: LoteLancamentoDTO, object, obrigatório)

required

Request body schema: LoteLancamentoDTO

Returns:

Type Description
ProdutosLotesIdLoteLancamentosPostResponse200

Bling API response. Response schemas: 200: LoteLancamentoDTO; 400: ErrorResponse; 404: ErrorResponse

Source code in src/bling_erp_api/resources/product_batch_entries.py
def criar(
    self, id_lote: int, dados: LoteLancamentoDTO
) -> ProdutosLotesIdLoteLancamentosPostResponse200:
    """Cria um lançamento de um lote.

    Endpoint: POST /produtos/lotes/{idLote}/lancamentos

    Inclui lançamento de um lote.

    Args:
        id_lote: ID do lote (Bling: ``idLote``, integer, obrigatório)
        dados: Dados do lançamento do lote (Bling: ``LoteLancamentoDTO``, object, obrigatório)

    Request body schema: LoteLancamentoDTO

    Returns:
        Bling API response. Response schemas: 200: LoteLancamentoDTO; 400: ErrorResponse; 404: ErrorResponse
    """
    raw = self._post(f"/produtos/lotes/{id_lote}/lancamentos", json=to_json_object(dados))
    return self._validate_response(ProdutosLotesIdLoteLancamentosPostResponse200, raw)