fix: devolver códigos de error como strings (#52)

* fix: return API error codes as strings

* fix: only normalize numeric API error codes

Author: javorosas

VERSION.md

@@ -1,3 +1,8 @@
+4.7.1
+
+## Fixed
+- Return numeric API error codes as strings.
+
 4.7.0
 
 ## Added

src/Exceptions/FacturapiException.php

@@ -48,9 +48,22 @@ public function getRawBody(): ?string
 		return $this->rawBody;
 	}
 
-	public function getErrorCode(): mixed
+	public function getErrorCode(): ?string
 	{
-		return is_array($this->errorData) ? ($this->errorData['code'] ?? null) : null;
+		if (!is_array($this->errorData) || !array_key_exists('code', $this->errorData)) {
+			return null;
+		}
+
+		$code = $this->errorData['code'];
+		if ($code === null) {
+			return null;
+		}
+
+		if (is_string($code)) {
+			return $code;
+		}
+
+		return is_int($code) || is_float($code) ? (string) $code : null;
 	}
 
 	public function getErrorPath(): ?string

tests/Http/ErrorHandlingTest.php

@@ -89,4 +89,20 @@ public function testNonJsonErrorsStillExposeRawBody(): void
             self::assertSame($rawBody, $exception->getRawBody());
         }
     }
+
+    public function testNumericApiErrorCodesAreConvertedToStrings(): void
+    {
+        $httpClient = new FakeHttpClient(
+            new Response(400, ['Content-Type' => 'application/json'], '{"code": 400}')
+        );
+
+        $invoices = new Invoices('sk_test_abc123', ['httpClient' => $httpClient]);
+
+        try {
+            $invoices->create(['customer' => []]);
+            self::fail('Expected FacturapiException to be thrown.');
+        } catch (FacturapiException $exception) {
+            self::assertSame('400', $exception->getErrorCode());
+        }
+    }
 }