Skip to content

Logísticas - Remessas

bling_erp_api.resources.logisticas_remessas.LogisticasRemessasResource

LogisticasRemessasResource(transport: Transport)

Bases: BaseResource

Operações de remessas de logísticas do Bling. Mapeia /logisticas/remessas.

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_por_logistica

listar_por_logistica(
    id_logistica: int,
) -> LogisticasIdLogisticaRemessasGetResponse200

Lista remessas de uma logística.

Endpoint: GET /logisticas/{idLogistica}/remessas

Obtém as remessas de postagem de uma logística pelo ID.

Parameters:

Name Type Description Default
id_logistica int

ID da logística (Bling: idLogistica, integer, obrigatório)

required

Returns:

Type Description
LogisticasIdLogisticaRemessasGetResponse200

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

Source code in src/bling_erp_api/resources/logisticas_remessas.py
def listar_por_logistica(
    self, id_logistica: int
) -> LogisticasIdLogisticaRemessasGetResponse200:
    """Lista remessas de uma logística.

    Endpoint: GET /logisticas/{idLogistica}/remessas

    Obtém as remessas de postagem de uma logística pelo ID.

    Args:
        id_logistica: ID da logística (Bling: ``idLogistica``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 200: LogisticasRemessasDadosDTO; 400: ErrorResponse; 404: ErrorResponse
    """
    raw = self._get(f"/logisticas/{id_logistica}/remessas")
    return self._validate_response(LogisticasIdLogisticaRemessasGetResponse200, raw)

obter

obter(id_remessa: int) -> LogisticasRemessasIdRemessaGetResponse200

Obtém uma remessa de postagem.

Endpoint: GET /logisticas/remessas/{idRemessa}

Obtém uma remessa de postagem pelo ID.

Parameters:

Name Type Description Default
id_remessa int

ID da remessa de postagem (Bling: idRemessa, integer, obrigatório)

required

Returns:

Type Description
LogisticasRemessasIdRemessaGetResponse200

Bling API response. Response schemas: 200: LogisticasRemessasDadosBaseDTO; 404: ErrorResponse

Source code in src/bling_erp_api/resources/logisticas_remessas.py
def obter(self, id_remessa: int) -> LogisticasRemessasIdRemessaGetResponse200:
    """Obtém uma remessa de postagem.

    Endpoint: GET /logisticas/remessas/{idRemessa}

    Obtém uma remessa de postagem pelo ID.

    Args:
        id_remessa: ID da remessa de postagem (Bling: ``idRemessa``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 200: LogisticasRemessasDadosBaseDTO; 404: ErrorResponse
    """
    raw = self._get(f"/logisticas/remessas/{id_remessa}")
    return self._validate_response(LogisticasRemessasIdRemessaGetResponse200, raw)

criar

criar(dados: JsonObject) -> LogisticasRemessasPostResponse201

Cria uma remessa de postagem.

Endpoint: POST /logisticas/remessas

Cria uma remessa de postagem de uma logística.

Parameters:

Name Type Description Default
dados JsonObject

Dados da remessa (Bling: request body, object, obrigatório)

required

Returns:

Type Description
LogisticasRemessasPostResponse201

Bling API response. Response schemas: 201: LogisticasRemessaRemessaDTO; 400: ErrorResponse

Source code in src/bling_erp_api/resources/logisticas_remessas.py
def criar(self, dados: JsonObject) -> LogisticasRemessasPostResponse201:
    """Cria uma remessa de postagem.

    Endpoint: POST /logisticas/remessas

    Cria uma remessa de postagem de uma logística.

    Args:
        dados: Dados da remessa (Bling: request body, object, obrigatório)

    Returns:
        Bling API response. Response schemas: 201: LogisticasRemessaRemessaDTO; 400: ErrorResponse
    """
    raw = self._post("/logisticas/remessas", json=to_json_object(dados))
    return self._validate_response(LogisticasRemessasPostResponse201, raw)

alterar

alterar(
    id_remessa: int, dados: JsonObject
) -> LogisticasRemessasIdRemessaPutResponse200

Altera uma remessa de postagem.

Endpoint: PUT /logisticas/remessas/{idRemessa}

Altera uma remessa de postagem pelo ID.

Parameters:

Name Type Description Default
id_remessa int

ID da remessa de postagem (Bling: idRemessa, integer, obrigatório)

required
dados JsonObject

Dados da remessa (Bling: request body, object, obrigatório)

required

Returns:

Type Description
LogisticasRemessasIdRemessaPutResponse200

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

Source code in src/bling_erp_api/resources/logisticas_remessas.py
def alterar(
    self, id_remessa: int, dados: JsonObject
) -> LogisticasRemessasIdRemessaPutResponse200:
    """Altera uma remessa de postagem.

    Endpoint: PUT /logisticas/remessas/{idRemessa}

    Altera uma remessa de postagem pelo ID.

    Args:
        id_remessa: ID da remessa de postagem (Bling: ``idRemessa``, integer, obrigatório)
        dados: Dados da remessa (Bling: request body, object, obrigatório)

    Returns:
        Bling API response. Response schemas: 200: LogisticasRemessaRemessaDTO; 400: ErrorResponse; 404: ErrorResponse
    """
    raw = self._put(f"/logisticas/remessas/{id_remessa}", json=to_json_object(dados))
    return self._validate_response(LogisticasRemessasIdRemessaPutResponse200, raw)

remover

remover(id_remessa: int) -> JsonObject

Remove uma remessa de postagem.

Endpoint: DELETE /logisticas/remessas/{idRemessa}

Remove uma remessa de postagem pelo ID.

Parameters:

Name Type Description Default
id_remessa int

ID da remessa de postagem (Bling: idRemessa, 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/logisticas_remessas.py
def remover(self, id_remessa: int) -> JsonObject:
    """Remove uma remessa de postagem.

    Endpoint: DELETE /logisticas/remessas/{idRemessa}

    Remove uma remessa de postagem pelo ID.

    Args:
        id_remessa: ID da remessa de postagem (Bling: ``idRemessa``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 400: ErrorResponse; 404: ErrorResponse
    """
    return self._delete(f"/logisticas/remessas/{id_remessa}")