feat: atualizar para v306

Author: AlexandreBellas

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 `v305` da API ([veja o registro de alterações](https://developer.bling.com.br/changelogs#2024-07-24)).
+Atualizado com a versão `v306` da API ([veja o registro de alterações](https://developer.bling.com.br/changelogs#2024-08-16)).
 
 ## Instalação
 

src/Entities/Nfces/Schema/Find/FindResponseData.php

@@ -21,7 +21,15 @@
      * @param FindResponseDataContato $contato
      * @param ?Id $naturezaOperacao
      * @param ?Id $loja
-     * @param string $serie
+     * @param ?int $serie
+     * @param ?float $valorNota
+     * @param ?string $chaveAcesso
+     * @param ?string $xml
+     * @param ?string $linkDanfe
+     * @param ?string $linkPDF
+     * @param ?string $numeroPedidoLoja
+     * @param ?FindResponseDataTransporte $transporte
+     * @param ?Id $vendedor
      */
     public function __construct(
         public ?int $id,
@@ -33,7 +41,14 @@ public function __construct(
         public FindResponseDataContato $contato,
         public ?Id $naturezaOperacao,
         public ?Id $loja,
-        public string $serie,
-    ) {
-    }
+        public ?int $serie,
+        public ?float $valorNota,
+        public ?string $chaveAcesso,
+        public ?string $xml,
+        public ?string $linkDanfe,
+        public ?string $linkPDF,
+        public ?string $numeroPedidoLoja,
+        public ?FindResponseDataTransporte $transporte,
+        public ?Id $vendedor,
+    ) {}
 }

src/Entities/Nfces/Schema/Find/FindResponseDataTransporte.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace AleBatistella\BlingErpApi\Entities\Nfces\Schema\Find;
+
+use AleBatistella\BlingErpApi\Entities\Shared\BaseResponseObject;
+use AleBatistella\BlingErpApi\Entities\Nfes\Enum\FretePorConta;
+use AleBatistella\BlingErpApi\Entities\Shared\DTO\Schema\Id;
+
+readonly final class FindResponseDataTransporte extends BaseResponseObject
+{
+    /**
+     * Constrói o objeto.
+     *
+     * @param ?FretePorConta $fretePorConta
+     * @param ?FindResponseDataTransporteTransportador $transportador
+     * @param ?Id[] $volumes
+     * @param ?FindResponseDataTransporteEtiqueta $etiqueta
+     */
+    public function __construct(
+        public ?FretePorConta $fretePorConta,
+        public ?FindResponseDataTransporteTransportador $transportador,
+        public ?array $volumes,
+        public ?FindResponseDataTransporteEtiqueta $etiqueta,
+    ) {}
+
+    /**
+     * @inheritDoc
+     */
+    protected static function fromRules(): array
+    {
+        return [
+            'volumes' => Id::class
+        ];
+    }
+}

src/Entities/Nfces/Schema/Find/FindResponseDataTransporteEtiqueta.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace AleBatistella\BlingErpApi\Entities\Nfces\Schema\Find;
+
+use AleBatistella\BlingErpApi\Entities\Shared\BaseResponseObject;
+
+readonly final class FindResponseDataTransporteEtiqueta extends BaseResponseObject
+{
+    /**
+     * Constrói o objeto.
+     *
+     * @param ?string $nome
+     * @param ?string $endereco
+     * @param ?string $numero
+     * @param ?string $complemento
+     * @param ?string $municipio
+     * @param ?string $uf
+     * @param ?string $cep
+     * @param ?string $bairro
+     */
+    public function __construct(
+        public ?string $nome,
+        public ?string $endereco,
+        public ?string $numero,
+        public ?string $complemento,
+        public ?string $municipio,
+        public ?string $uf,
+        public ?string $cep,
+        public ?string $bairro,
+    ) {}
+}

src/Entities/Nfces/Schema/Find/FindResponseDataTransporteTransportador.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace AleBatistella\BlingErpApi\Entities\Nfces\Schema\Find;
+
+use AleBatistella\BlingErpApi\Entities\Shared\BaseResponseObject;
+
+readonly final class FindResponseDataTransporteTransportador extends BaseResponseObject
+{
+    /**
+     * Constrói o objeto.
+     *
+     * @param string $nome
+     * @param ?string $numeroDocumento
+     */
+    public function __construct(
+        public string $nome,
+        public ?string $numeroDocumento,
+    ) {}
+}

src/Entities/Nfces/__tests__/find/response.json

@@ -31,6 +31,37 @@
         "loja": {
             "id": 12345678
         },
-        "serie": "1"
+        "serie": 1,
+        "valorNota": 10.3,
+        "chaveAcesso": "string",
+        "xml": "string",
+        "linkDanfe": "string",
+        "linkPDF": "string",
+        "numeroPedidoLoja": "string",
+        "transporte": {
+            "fretePorConta": 0,
+            "transportador": {
+                "nome": "Transportador",
+                "numeroDocumento": "30188025000121"
+            },
+            "volumes": [
+                {
+                    "id": 12345678
+                }
+            ],
+            "etiqueta": {
+                "nome": "Transportador",
+                "endereco": "Olavo Bilac",
+                "numero": "914",
+                "complemento": "Sala 101",
+                "municipio": "Bento Gonçalves",
+                "uf": "RS",
+                "cep": "95702-000",
+                "bairro": "Imigrante"
+            }
+        },
+        "vendedor": {
+            "id": 12345679
+        }
     }
 }

src/Entities/Nfes/Schema/Find/FindResponseData.php

@@ -22,11 +22,14 @@
      * @param ?Id $naturezaOperacao
      * @param ?Id $loja
      * @param ?int $serie
+     * @param ?float $valorNota
      * @param ?string $chaveAcesso
      * @param ?string $xml
      * @param ?string $linkDanfe
      * @param ?string $linkPDF
+     * @param ?string $numeroPedidoLoja
      * @param ?FindResponseDataTransporte $transporte
+     * @param ?Id $vendedor
      */
     public function __construct(
         public ?int $id,
@@ -39,11 +42,13 @@ public function __construct(
         public ?Id $naturezaOperacao,
         public ?Id $loja,
         public ?int $serie,
+        public ?float $valorNota,
         public ?string $chaveAcesso,
         public ?string $xml,
         public ?string $linkDanfe,
         public ?string $linkPDF,
+        public ?string $numeroPedidoLoja,
         public ?FindResponseDataTransporte $transporte,
-    ) {
-    }
+        public ?Id $vendedor,
+    ) {}
 }

src/Entities/Nfes/__tests__/find/response.json

@@ -32,10 +32,12 @@
             "id": 12345678
         },
         "serie": 1,
+        "valorNota": 10.3,
         "chaveAcesso": "string",
         "xml": "string",
         "linkDanfe": "string",
         "linkPDF": "string",
+        "numeroPedidoLoja": "string",
         "transporte": {
             "fretePorConta": 0,
             "transportador": {
@@ -57,6 +59,9 @@
                 "cep": "95702-000",
                 "bairro": "Imigrante"
             }
+        },
+        "vendedor": {
+            "id": 12345679
         }
     }
 }