feat: implementar OrdensDeProducao e atualizar entidades de Produtos

README.md

@@ -6,7 +6,7 @@
 Pacote de integração com a [API v3 do ERP Bling](https://developer.bling.com.br)
 para PHP 8.2+. O mais completo existente.
 
-Atualizado com a versão `v301` da API ([veja o registro de alterações](https://developer.bling.com.br/changelogs#2024-05-22)).
+Atualizado com a versão `v303` da API ([veja o registro de alterações](https://developer.bling.com.br/changelogs#2024-06-19)).
 
 ## Instalação
 
@@ -66,7 +66,7 @@ Quase todas as entidades do Bling atualmente são permitidas para interação. S
 - [x] Notas Fiscais de Serviço Eletrônicas (`->nfses`)
 - [x] Notas Fiscais Eletrônicas (`->nfes`)
 - [x] Notificações (`->notificacoes`)
-- [ ] Ordens de produção (`->ordensDeProducao`)
+- [x] Ordens de produção (`->ordensDeProducao`)
 - [x] Pedidos - Compras (`->pedidosCompras`)
 - [x] Pedidos - Vendas (`->pedidosVendas`)
 - [x] Produtos (`->produtos`)

composer.json

@@ -2,7 +2,7 @@
   "name": "alebatistella/bling-erp-api",
   "description": "Pacote de integração com a API do Bling ERP",
   "type": "library",
-  "version": "1.14.2",
+  "version": "1.15.0",
   "license": "MIT",
   "autoload": {
     "psr-4": {

src/Bling.php

@@ -29,6 +29,7 @@
 use AleBatistella\BlingErpApi\Entities\Nfes\Nfes;
 use AleBatistella\BlingErpApi\Entities\Nfses\Nfses;
 use AleBatistella\BlingErpApi\Entities\Notificacoes\Notificacoes;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\OrdensDeProducao;
 use AleBatistella\BlingErpApi\Entities\PedidosCompras\PedidosCompras;
 use AleBatistella\BlingErpApi\Entities\PedidosVendas\PedidosVendas;
 use AleBatistella\BlingErpApi\Entities\Produtos\Produtos;
@@ -76,6 +77,7 @@
  * @property Nfses $nfses
  * @property Nfes $nfes
  * @property Notificacoes $notificacoes
+ * @property OrdensDeProducao $ordensDeProducao
  * @property PedidosCompras $pedidosCompras
  * @property PedidosVendas $pedidosVendas
  * @property Produtos $produtos
@@ -157,6 +159,7 @@ public function __get(string $name)
       'nfses' => $this->getModule(Nfses::class),
       'nfes' => $this->getModule(Nfes::class),
       'notificacoes' => $this->getModule(Notificacoes::class),
+      'ordensDeProducao' => $this->getModule(OrdensDeProducao::class),
       'pedidosCompras' => $this->getModule(PedidosCompras::class),
       'pedidosVendas' => $this->getModule(PedidosVendas::class),
       'produtos' => $this->getModule(Produtos::class),

src/BlingTest.spec.php

@@ -30,6 +30,7 @@
 use AleBatistella\BlingErpApi\Entities\Nfes\Nfes;
 use AleBatistella\BlingErpApi\Entities\Nfses\Nfses;
 use AleBatistella\BlingErpApi\Entities\Notificacoes\Notificacoes;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\OrdensDeProducao;
 use AleBatistella\BlingErpApi\Entities\PedidosCompras\PedidosCompras;
 use AleBatistella\BlingErpApi\Entities\PedidosVendas\PedidosVendas;
 use AleBatistella\BlingErpApi\Entities\Produtos\Produtos;
@@ -466,6 +467,20 @@ public function testShouldGetNotificacoesCorrectly(): void
     $this->assertInstanceOf($expected, $actual);
   }
 
+  /**
+   * Testa obter a entidade Ordens de Produção.
+   *
+   * @return void
+   */
+  public function testShouldGetOrdensDeProducaoCorrectly(): void
+  {
+    $expected = OrdensDeProducao::class;
+
+    $actual = $this->getInstance()->ordensDeProducao;
+
+    $this->assertInstanceOf($expected, $actual);
+  }
+
   /**
    * Testa obter a entidade Pedidos de Compras.
    *

src/Entities/Empresas/Schema/Get/GetResponseData.php

@@ -9,14 +9,17 @@
     /**
      * Constrói o objeto.
      *
+     * @param ?string $id
      * @param ?string $nome
      * @param ?string $cnpj
      * @param ?string $email
+     * @param ?string $dataContrato
      */
     public function __construct(
+        public ?string $id,
         public ?string $nome,
         public ?string $cnpj,
         public ?string $email,
-    ) {
-    }
+        public ?string $dataContrato,
+    ) {}
 }

src/Entities/Empresas/__tests__/get/response.json

@@ -1,7 +1,9 @@
 {
   "data": {
+    "id": "436c56a5679921f5f13a3d6433561773",
     "nome": "Empresa Teste LTDA",
     "cnpj": "12.345.657/8910-11",
-    "email": "empresa@email.com"
+    "email": "empresa@email.com",
+    "dataContrato": "2024-12-31"
   }
 }

src/Entities/OrdensDeProducao/OrdensDeProducao.php

@@ -0,0 +1,176 @@
+<?php
+
+namespace AleBatistella\BlingErpApi\Entities\OrdensDeProducao;
+
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\Get\GetParams;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\Create\CreateResponse;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\Delete\DeleteResponse;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\Find\FindResponse;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\GenerateOverDemand\GenerateOverDemandResponse;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\Get\GetResponse;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\Update\UpdateResponse;
+use AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\ChangeSituation\ChangeSituationResponse;
+use AleBatistella\BlingErpApi\Entities\Shared\BaseEntity;
+use AleBatistella\BlingErpApi\Entities\Shared\DTO\Request\RequestOptions;
+use AleBatistella\BlingErpApi\Exceptions\BlingApiException;
+use AleBatistella\BlingErpApi\Exceptions\BlingInternalException;
+
+/**
+ * Entidade para interação com ordens de produção.
+ *
+ * @see https://developer.bling.com.br/referencia#/Ordens%20de%20Produ%C3%A7%C3%A3o
+ */
+class OrdensDeProducao extends BaseEntity
+{
+    /**
+     * Remove uma ordem de produção.
+     *
+     * @param int $idOrdemProducao ID da ordem de produção
+     *
+     * @return null
+     * @throws BlingApiException|BlingInternalException
+     *
+     * @see https://developer.bling.com.br/referencia#/Ordens%20de%20Produ%C3%A7%C3%A3o/delete_ordens_producao__idOrdemProducao_
+     */
+    public function delete(int $idOrdemProducao): null
+    {
+        $response = $this->repository->destroy(
+            new RequestOptions(
+                endpoint: "ordens-producao/$idOrdemProducao"
+            )
+        );
+
+        return DeleteResponse::fromResponse($response);
+    }
+
+    /**
+     * Obtém ordens de produção.
+     *
+     * @param GetParams|array|null $params Parâmetros para a busca
+     * 
+     * @return GetResponse
+     * @throws BlingApiException|BlingInternalException
+     *
+     * @see https://developer.bling.com.br/referencia#/Ordens%20de%20Produ%C3%A7%C3%A3o/get_ordens_producao
+     */
+    public function get(GetParams|array|null $params = null): GetResponse
+    {
+        $response = $this->repository->index(
+            new RequestOptions(
+                endpoint: "ordens-producao",
+                queryParams: $params
+            )
+        );
+
+        return GetResponse::fromResponse($response);
+    }
+
+    /**
+     * Obtém uma ordem de produção.
+     * 
+     * @param int $idOrdemProducao ID da ordem de produção
+     * 
+     * @return FindResponse
+     * @throws BlingApiException|BlingInternalException
+     * 
+     * @see https://developer.bling.com.br/referencia#/Ordens%20de%20Produ%C3%A7%C3%A3o/get_ordens_producao__idOrdemProducao_
+     */
+    public function find(int $idOrdemProducao): FindResponse
+    {
+        $response = $this->repository->show(
+            new RequestOptions(
+                endpoint: "ordens-producao/$idOrdemProducao",
+            )
+        );
+
+        return FindResponse::fromResponse($response);
+    }
+
+    /**
+     * Cria uma ordem de produção.
+     * 
+     * @param array $body Corpo da requisição
+     * 
+     * @return CreateResponse
+     * @throws BlingApiException|BlingInternalException
+     * 
+     * @see https://developer.bling.com.br/referencia#/Ordens%20de%20Produ%C3%A7%C3%A3o/post_ordens_producao
+     */
+    public function create(array $body): CreateResponse
+    {
+        $response = $this->repository->store(
+            new RequestOptions(
+                endpoint: "ordens-producao",
+                body: $body
+            )
+        );
+
+        return CreateResponse::fromResponse($response);
+    }
+
+    /**
+     * Gera ordens de produção sob demanda.
+     * 
+     * @return GenerateOverDemandResponse
+     * @throws BlingApiException|BlingInternalException
+     * 
+     * @see https://developer.bling.com.br/referencia#/Ordens%20de%20Produ%C3%A7%C3%A3o/post_ordens_producao_gerar_sob_demanda
+     */
+    public function generateOverDemand(): GenerateOverDemandResponse
+    {
+        $response = $this->repository->store(
+            new RequestOptions(
+                endpoint: "ordens-producao/gerar-sob-demanda"
+            )
+        );
+
+        return GenerateOverDemandResponse::fromResponse($response);
+    }
+
+    /**
+     * Altera uma ordem de produção.
+     * 
+     * @param int $idOrdemProducao ID da ordem de produção
+     * @param array $body Corpo da requisição
+     * 
+     * @return UpdateResponse
+     * @throws BlingApiException|BlingInternalException
+     * 
+     * @see https://developer.bling.com.br/referencia#/Ordens%20de%20Produ%C3%A7%C3%A3o/put_ordens_producao__idOrdemProducao_
+     */
+    public function update(int $idOrdemProducao, array $body): null
+    {
+        $response = $this->repository->replace(
+            new RequestOptions(
+                endpoint: "ordens-producao/$idOrdemProducao",
+                body: $body
+            )
+        );
+
+        return UpdateResponse::fromResponse($response);
+    }
+
+
+    /**
+     * Altera a situação de uma ordem de produção.
+     * 
+     * @param int $idOrdemProducao ID da ordem de produção
+     * @param array $body Corpo da requisição
+     * 
+     * @return ChangeSituationResponse
+     * @throws BlingApiException|BlingInternalException
+     * 
+     * @see https://developer.bling.com.br/referencia#/Ordens%20de%20Produ%C3%A7%C3%A3o/put_ordens_producao__idOrdemProducao__situacoes
+     */
+    public function changeSituation(int $idOrdemProducao, array $body): null
+    {
+        $response = $this->repository->replace(
+            new RequestOptions(
+                endpoint: "ordens-producao/$idOrdemProducao/situacoes",
+                body: $body
+            )
+        );
+
+        return ChangeSituationResponse::fromResponse($response);
+    }
+}

src/Entities/OrdensDeProducao/Schema/ChangeSituation/ChangeSituationResponse.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\ChangeSituation;
+
+use AleBatistella\BlingErpApi\Entities\Shared\BaseResponseRootObject;
+use AleBatistella\BlingErpApi\Entities\Shared\DTO\Request\ResponseOptions;
+
+/**
+ * Resposta da alteração da situação de uma ordem de produção pelo ID.
+ */
+readonly final class ChangeSituationResponse extends BaseResponseRootObject
+{
+    /**
+     * @inheritDoc
+     */
+    public static function fromResponse(ResponseOptions $response): null
+    {
+        if (!is_null($response->body?->content)) {
+            static::throwForInconsistentResponseOptions($response);
+        }
+
+        return null;
+    }
+}

src/Entities/OrdensDeProducao/Schema/Create/CreateResponse.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\Create;
+
+use AleBatistella\BlingErpApi\Entities\Shared\BaseResponseRootObject;
+use AleBatistella\BlingErpApi\Entities\Shared\DTO\Request\ResponseOptions;
+use AleBatistella\BlingErpApi\Entities\Shared\DTO\Schema\Id;
+
+/**
+ * Resposta da criação de uma ordem de produção.
+ */
+readonly final class CreateResponse extends BaseResponseRootObject
+{
+    /**
+     * Constrói o objeto.
+     *
+     * @param Id $data
+     */
+    public function __construct(
+        public Id $data
+    ) {}
+
+    /**
+     * @inheritDoc
+     */
+    public static function fromResponse(ResponseOptions $response): static
+    {
+        if (is_null($response->body?->content)) {
+            static::throwForInconsistentResponseOptions($response);
+        }
+
+        return self::from($response->body->content);
+    }
+}

src/Entities/OrdensDeProducao/Schema/Delete/DeleteResponse.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace AleBatistella\BlingErpApi\Entities\OrdensDeProducao\Schema\Delete;
+
+use AleBatistella\BlingErpApi\Entities\Shared\BaseResponseRootObject;
+use AleBatistella\BlingErpApi\Entities\Shared\DTO\Request\ResponseOptions;
+
+/**
+ * Resposta da remoção de uma ordem de produção pelo ID.
+ */
+readonly final class DeleteResponse extends BaseResponseRootObject
+{
+    /**
+     * @inheritDoc
+     */
+    public static function fromResponse(ResponseOptions $response): null
+    {
+        if (!is_null($response->body?->content)) {
+            static::throwForInconsistentResponseOptions($response);
+        }
+
+        return null;
+    }
+}