Skip to content

Ordens de Produção

bling_erp_api.resources.ordens_producao.OrdensProducaoResource 

OrdensProducaoResource(transport: Transport)

Bases: BaseResource

Ordens de Produção.

Endpoints mapeados: - GET /ordens-producao - POST /ordens-producao - GET /ordens-producao/{idOrdemProducao} - PUT /ordens-producao/{idOrdemProducao} - DELETE /ordens-producao/{idOrdemProducao} - PUT /ordens-producao/{idOrdemProducao}/situacoes - POST /ordens-producao/gerar-sob-demanda

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 | None = None,
    limite: int | None = None,
    ids_situacoes: list[int] | None = None,
) -> OrdensProducaoGetResponse200

Lista ordens de produção.

Endpoint: GET /ordens-producao

Lista ordens de produção com paginação e filtro de situações.

Parameters:

Name Type Description Default
pagina int | None

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

 None
limite int | None

Quantidade de registros por página (Bling: limite, integer, opcional)

 None
ids_situacoes list[int] | None

IDs das situações para filtrar (Bling: idsSituacoes[], array de integer, opcional)

 None

Returns:

Type Description
OrdensProducaoGetResponse200

Bling API response. Response schemas: 200: OrdensProducaoDadosBaseDTO[]; 400: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
def listar(
    self,
    *,
    pagina: int | None = None,
    limite: int | None = None,
    ids_situacoes: list[int] | None = None,
) -> OrdensProducaoGetResponse200:
    """Lista ordens de produção.

    Endpoint: GET /ordens-producao

    Lista ordens de produção com paginação e filtro de situações.

    Args:
        pagina: Nº da página (Bling: ``pagina``, integer, opcional)
        limite: Quantidade de registros por página (Bling: ``limite``, integer, opcional)
        ids_situacoes: IDs das situações para filtrar (Bling: ``idsSituacoes[]``, array de integer, opcional)

    Returns:
        Bling API response. Response schemas: 200: OrdensProducaoDadosBaseDTO[]; 400: ErrorResponse
    """
    params = compact_params(
        {
            "pagina": pagina,
            "limite": limite,
            "idsSituacoes[]": ids_situacoes,
        }
    )
    raw = self._get("/ordens-producao", params=params)
    return self._validate_response(OrdensProducaoGetResponse200, raw)

criar 

criar(dados: JsonObject) -> OrdensProducaoPostResponse201

Cria uma ordem de produção.

Endpoint: POST /ordens-producao

Cria uma nova ordem de produção.

Parameters:

Name Type Description Default
dados JsonObject

Dados da ordem de produção (Bling: OrdensProducaoCreateRequestDTO, obrigatório)

 required

Returns:

Type Description
OrdensProducaoPostResponse201

Bling API response. Response schemas: 201: BasePostResponse; 400: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
def criar(self, dados: JsonObject) -> OrdensProducaoPostResponse201:
    """Cria uma ordem de produção.

    Endpoint: POST /ordens-producao

    Cria uma nova ordem de produção.

    Args:
        dados: Dados da ordem de produção (Bling: ``OrdensProducaoCreateRequestDTO``, obrigatório)

    Returns:
        Bling API response. Response schemas: 201: BasePostResponse; 400: ErrorResponse
    """
    raw = self._post("/ordens-producao", json=to_json_object(dados))
    return self._validate_response(OrdensProducaoPostResponse201, raw)

obter 

obter(id_ordem_producao: int) -> OrdensProducaoIdOrdemProducaoGetResponse200

Obtém uma ordem de produção.

Endpoint: GET /ordens-producao/{idOrdemProducao}

Obtém uma ordem de produção pelo ID.

Parameters:

Name Type Description Default
id_ordem_producao int

ID da ordem de produção (Bling: idOrdemProducao, integer, obrigatório)

 required

Returns:

Type Description
OrdensProducaoIdOrdemProducaoGetResponse200

Bling API response. Response schemas: 200: OrdensProducaoDetailResponseDTO; 404: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
def obter(self, id_ordem_producao: int) -> OrdensProducaoIdOrdemProducaoGetResponse200:
    """Obtém uma ordem de produção.

    Endpoint: GET /ordens-producao/{idOrdemProducao}

    Obtém uma ordem de produção pelo ID.

    Args:
        id_ordem_producao: ID da ordem de produção (Bling: ``idOrdemProducao``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 200: OrdensProducaoDetailResponseDTO; 404: ErrorResponse
    """
    raw = self._get(f"/ordens-producao/{id_ordem_producao}")
    return self._validate_response(OrdensProducaoIdOrdemProducaoGetResponse200, raw)

alterar 

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

Altera uma ordem de produção.

Endpoint: PUT /ordens-producao/{idOrdemProducao}

Altera integralmente uma ordem de produção.

Parameters:

Name Type Description Default
id_ordem_producao int

ID da ordem de produção (Bling: idOrdemProducao, integer, obrigatório)

 required
dados JsonObject

Dados da ordem de produção (Bling: OrdensProducaoCreateRequestDTO, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 204: NoContent; 400: ErrorResponse; 404: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
def alterar(self, id_ordem_producao: int, dados: JsonObject) -> JsonObject:
    """Altera uma ordem de produção.

    Endpoint: PUT /ordens-producao/{idOrdemProducao}

    Altera integralmente uma ordem de produção.

    Args:
        id_ordem_producao: ID da ordem de produção (Bling: ``idOrdemProducao``, integer, obrigatório)
        dados: Dados da ordem de produção (Bling: ``OrdensProducaoCreateRequestDTO``, obrigatório)

    Returns:
        Bling API response. Response schemas: 204: NoContent; 400: ErrorResponse; 404: ErrorResponse
    """
    return self._put(
        f"/ordens-producao/{id_ordem_producao}",
        json=to_json_object(dados),
    )

remover 

remover(id_ordem_producao: int) -> JsonObject

Remove uma ordem de produção.

Endpoint: DELETE /ordens-producao/{idOrdemProducao}

Remove uma ordem de produção pelo ID.

Parameters:

Name Type Description Default
id_ordem_producao int

ID da ordem de produção (Bling: idOrdemProducao, integer, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 204: NoContent; 404: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
126
127
128
129
130
131
132
133
134
135
136
137
138
139
def remover(self, id_ordem_producao: int) -> JsonObject:
    """Remove uma ordem de produção.

    Endpoint: DELETE /ordens-producao/{idOrdemProducao}

    Remove uma ordem de produção pelo ID.

    Args:
        id_ordem_producao: ID da ordem de produção (Bling: ``idOrdemProducao``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 204: NoContent; 404: ErrorResponse
    """
    return self._delete(f"/ordens-producao/{id_ordem_producao}")

alterar_situacao 

alterar_situacao(id_ordem_producao: int, dados: JsonObject) -> JsonObject

Altera a situação de uma ordem de produção.

Endpoint: PUT /ordens-producao/{idOrdemProducao}/situacoes

Altera a situação de uma ordem de produção (ex: finalizar, cancelar).

Parameters:

Name Type Description Default
id_ordem_producao int

ID da ordem de produção (Bling: idOrdemProducao, integer, obrigatório)

 required
dados JsonObject

Dados da situação (Bling: OrdensProducaoSituacaoDadosDTO, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 204: NoContent; 400: ErrorResponse; 404: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
def alterar_situacao(
    self,
    id_ordem_producao: int,
    dados: JsonObject,
) -> JsonObject:
    """Altera a situação de uma ordem de produção.

    Endpoint: PUT /ordens-producao/{idOrdemProducao}/situacoes

    Altera a situação de uma ordem de produção (ex: finalizar, cancelar).

    Args:
        id_ordem_producao: ID da ordem de produção (Bling: ``idOrdemProducao``, integer, obrigatório)
        dados: Dados da situação (Bling: ``OrdensProducaoSituacaoDadosDTO``, obrigatório)

    Returns:
        Bling API response. Response schemas: 204: NoContent; 400: ErrorResponse; 404: ErrorResponse
    """
    return self._put(
        f"/ordens-producao/{id_ordem_producao}/situacoes",
        json=to_json_object(dados),
    )

criar_multiplos 

criar_multiplos() -> OrdensProducaoGerarSobDemandaPostResponse201

Gera ordens de produção sob demanda.

Endpoint: POST /ordens-producao/gerar-sob-demanda

Gera ordens de produção automaticamente com base no estoque mínimo.

Returns:

Type Description
OrdensProducaoGerarSobDemandaPostResponse201

Bling API response. Response schemas: 201: OrdensProducaoDadosGeradosPorDemandaDTO[]; 400: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
164
165
166
167
168
169
170
171
172
173
174
175
def criar_multiplos(self) -> OrdensProducaoGerarSobDemandaPostResponse201:
    """Gera ordens de produção sob demanda.

    Endpoint: POST /ordens-producao/gerar-sob-demanda

    Gera ordens de produção automaticamente com base no estoque mínimo.

    Returns:
        Bling API response. Response schemas: 201: OrdensProducaoDadosGeradosPorDemandaDTO[]; 400: ErrorResponse
    """
    raw = self._post("/ordens-producao/gerar-sob-demanda")
    return self._validate_response(OrdensProducaoGerarSobDemandaPostResponse201, raw)

list 

list(
    *,
    page: int | None = None,
    limit: int | None = None,
    status_ids: list[int] | None = None,
) -> OrdensProducaoGetResponse200

Compatibility alias for listar().

Lista ordens de produção.

Endpoint: GET /ordens-producao

Parameters:

Name Type Description Default
page int | None

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

 None
limit int | None

Quantidade de registros por página (Bling: limite, integer, opcional)

 None
status_ids list[int] | None

IDs das situações para filtrar (Bling: idsSituacoes[], array de integer, opcional)

 None

Returns:

Type Description
OrdensProducaoGetResponse200

Bling API response. Response schemas: 200: OrdensProducaoDadosBaseDTO[]; 400: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
def list(
    self,
    *,
    page: int | None = None,
    limit: int | None = None,
    status_ids: list[int] | None = None,
) -> OrdensProducaoGetResponse200:
    """Compatibility alias for ``listar()``.

    Lista ordens de produção.

    Endpoint: GET /ordens-producao

    Args:
        page: Nº da página (Bling: ``pagina``, integer, opcional)
        limit: Quantidade de registros por página (Bling: ``limite``, integer, opcional)
        status_ids: IDs das situações para filtrar (Bling: ``idsSituacoes[]``, array de integer, opcional)

    Returns:
        Bling API response. Response schemas: 200: OrdensProducaoDadosBaseDTO[]; 400: ErrorResponse
    """
    return self.listar(pagina=page, limite=limit, ids_situacoes=status_ids)

create 

create(data: JsonObject) -> OrdensProducaoPostResponse201

Compatibility alias for criar().

Cria uma ordem de produção.

Endpoint: POST /ordens-producao

Parameters:

Name Type Description Default
data JsonObject

Dados da ordem de produção (Bling: OrdensProducaoCreateRequestDTO, obrigatório)

 required

Returns:

Type Description
OrdensProducaoPostResponse201

Bling API response. Response schemas: 201: BasePostResponse; 400: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
202
203
204
205
206
207
208
209
210
211
212
213
214
215
def create(self, data: JsonObject) -> OrdensProducaoPostResponse201:
    """Compatibility alias for ``criar()``.

    Cria uma ordem de produção.

    Endpoint: POST /ordens-producao

    Args:
        data: Dados da ordem de produção (Bling: ``OrdensProducaoCreateRequestDTO``, obrigatório)

    Returns:
        Bling API response. Response schemas: 201: BasePostResponse; 400: ErrorResponse
    """
    return self.criar(dados=data)

get 

get(production_order_id: int) -> OrdensProducaoIdOrdemProducaoGetResponse200

Compatibility alias for obter().

Obtém uma ordem de produção.

Endpoint: GET /ordens-producao/{idOrdemProducao}

Parameters:

Name Type Description Default
production_order_id int

ID da ordem de produção (Bling: idOrdemProducao, integer, obrigatório)

 required

Returns:

Type Description
OrdensProducaoIdOrdemProducaoGetResponse200

Bling API response. Response schemas: 200: OrdensProducaoDetailResponseDTO; 404: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
217
218
219
220
221
222
223
224
225
226
227
228
229
230
def get(self, production_order_id: int) -> OrdensProducaoIdOrdemProducaoGetResponse200:
    """Compatibility alias for ``obter()``.

    Obtém uma ordem de produção.

    Endpoint: GET /ordens-producao/{idOrdemProducao}

    Args:
        production_order_id: ID da ordem de produção (Bling: ``idOrdemProducao``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 200: OrdensProducaoDetailResponseDTO; 404: ErrorResponse
    """
    return self.obter(id_ordem_producao=production_order_id)

update 

update(production_order_id: int, data: JsonObject) -> JsonObject

Compatibility alias for alterar().

Altera uma ordem de produção.

Endpoint: PUT /ordens-producao/{idOrdemProducao}

Parameters:

Name Type Description Default
production_order_id int

ID da ordem de produção (Bling: idOrdemProducao, integer, obrigatório)

 required
data JsonObject

Dados da ordem de produção (Bling: OrdensProducaoCreateRequestDTO, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 204: NoContent; 400: ErrorResponse; 404: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
def update(self, production_order_id: int, data: JsonObject) -> JsonObject:
    """Compatibility alias for ``alterar()``.

    Altera uma ordem de produção.

    Endpoint: PUT /ordens-producao/{idOrdemProducao}

    Args:
        production_order_id: ID da ordem de produção (Bling: ``idOrdemProducao``, integer, obrigatório)
        data: Dados da ordem de produção (Bling: ``OrdensProducaoCreateRequestDTO``, obrigatório)

    Returns:
        Bling API response. Response schemas: 204: NoContent; 400: ErrorResponse; 404: ErrorResponse
    """
    return self.alterar(id_ordem_producao=production_order_id, dados=data)

delete 

delete(production_order_id: int) -> JsonObject

Compatibility alias for remover().

Remove uma ordem de produção.

Endpoint: DELETE /ordens-producao/{idOrdemProducao}

Parameters:

Name Type Description Default
production_order_id int

ID da ordem de produção (Bling: idOrdemProducao, integer, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 204: NoContent; 404: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
248
249
250
251
252
253
254
255
256
257
258
259
260
261
def delete(self, production_order_id: int) -> JsonObject:
    """Compatibility alias for ``remover()``.

    Remove uma ordem de produção.

    Endpoint: DELETE /ordens-producao/{idOrdemProducao}

    Args:
        production_order_id: ID da ordem de produção (Bling: ``idOrdemProducao``, integer, obrigatório)

    Returns:
        Bling API response. Response schemas: 204: NoContent; 404: ErrorResponse
    """
    return self.remover(id_ordem_producao=production_order_id)

set_status 

set_status(production_order_id: int, data: JsonObject) -> JsonObject

Compatibility alias for alterar_situacao().

Altera a situação de uma ordem de produção.

Endpoint: PUT /ordens-producao/{idOrdemProducao}/situacoes

Parameters:

Name Type Description Default
production_order_id int

ID da ordem de produção (Bling: idOrdemProducao, integer, obrigatório)

 required
data JsonObject

Dados da situação (Bling: OrdensProducaoSituacaoDadosDTO, obrigatório)

 required

Returns:

Type Description
JsonObject

Bling API response. Response schemas: 204: NoContent; 400: ErrorResponse; 404: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
def set_status(self, production_order_id: int, data: JsonObject) -> JsonObject:
    """Compatibility alias for ``alterar_situacao()``.

    Altera a situação de uma ordem de produção.

    Endpoint: PUT /ordens-producao/{idOrdemProducao}/situacoes

    Args:
        production_order_id: ID da ordem de produção (Bling: ``idOrdemProducao``, integer, obrigatório)
        data: Dados da situação (Bling: ``OrdensProducaoSituacaoDadosDTO``, obrigatório)

    Returns:
        Bling API response. Response schemas: 204: NoContent; 400: ErrorResponse; 404: ErrorResponse
    """
    return self.alterar_situacao(id_ordem_producao=production_order_id, dados=data)

generate_on_demand 

generate_on_demand() -> OrdensProducaoGerarSobDemandaPostResponse201

Compatibility alias for criar_multiplos().

Gera ordens de produção sob demanda.

Endpoint: POST /ordens-producao/gerar-sob-demanda

Returns:

Type Description
OrdensProducaoGerarSobDemandaPostResponse201

Bling API response. Response schemas: 201: OrdensProducaoDadosGeradosPorDemandaDTO[]; 400: ErrorResponse
Source code in src/bling_erp_api/resources/ordens_producao.py 
279
280
281
282
283
284
285
286
287
288
289
def generate_on_demand(self) -> OrdensProducaoGerarSobDemandaPostResponse201:
    """Compatibility alias for ``criar_multiplos()``.

    Gera ordens de produção sob demanda.

    Endpoint: POST /ordens-producao/gerar-sob-demanda

    Returns:
        Bling API response. Response schemas: 201: OrdensProducaoDadosGeradosPorDemandaDTO[]; 400: ErrorResponse
    """
    return self.criar_multiplos()