From e8fc4d55de700aa18099dd7e95f34930c7837f3c Mon Sep 17 00:00:00 2001
From: Henrique <henrique.hohn@ixcsoft.com.br>
Date: Fri, 10 Jul 2026 08:08:01 -0300
Subject: [PATCH 1/2] fix(timeout exception): timeout exception

Added validation to catch timeout in communication with sefaz and thrown TimeoutException

Refs: IPERP-19446-QBMGSDBHNG-MASTER
---
 src/Exception/TimeoutException.php | 12 ++++++++++++
 src/Soap/SoapCurl.php              |  8 ++++++++
 2 files changed, 20 insertions(+)
 create mode 100755 src/Exception/TimeoutException.php

diff --git a/src/Exception/TimeoutException.php b/src/Exception/TimeoutException.php
new file mode 100755
index 00000000..41ca0c81
--- /dev/null
+++ b/src/Exception/TimeoutException.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace NFePHP\Common\Exception;
+
+class TimeoutException extends SoapException
+{
+    public static function timeoutFault($message, $code)
+    {
+        return new static("Erro de comunicação "
+            . "via soap, $message", $code);
+    }
+}
diff --git a/src/Soap/SoapCurl.php b/src/Soap/SoapCurl.php
index dcfca67a..5c196b1b 100755
--- a/src/Soap/SoapCurl.php
+++ b/src/Soap/SoapCurl.php
@@ -19,6 +19,7 @@
 use NFePHP\Common\Soap\SoapBase;
 use NFePHP\Common\Soap\SoapInterface;
 use NFePHP\Common\Exception\SoapException;
+use NFePHP\Common\Exception\TimeoutException;
 use NFePHP\Common\Validator;
 use NFePHP\Common\Certificate;
 
@@ -45,6 +46,7 @@ public function __construct(Certificate $certificate = null)
      * @param \SoapHeader $soapheader
      * @return string
      * @throws \NFePHP\Common\Exception\SoapException
+     * @throws \NFePHP\Common\Exception\TimeoutException
      */
     public function send(
         $url,
@@ -130,6 +132,12 @@ public function send(
         } catch (\Exception $e) {
             throw SoapException::unableToLoadCurl($e->getMessage());
         }
+        if ($this->soaperror_code === CURLE_OPERATION_TIMEDOUT) {
+            throw TimeoutException::timeoutFault(
+                "Timeout na comunicação com a SEFAZ [$url]: {$this->soaperror}",
+                CURLE_OPERATION_TIMEDOUT
+            );
+        }
         if ($this->soaperror != '') {
             if ((int)$this->soaperror_code == 0) {
                 $this->soaperror_code = 7;

From 68e4a2716ad16668e2d7df3f26260f1b210367fb Mon Sep 17 00:00:00 2001
From: Henrique <henrique.hohn@ixcsoft.com.br>
Date: Thu, 16 Jul 2026 12:13:39 -0300
Subject: [PATCH 2/2] feat(exceptions): throw custom exceptions

Throw custom exceptions for empty return from SEFAZ and code other than 200.

Refs: IPERP-19446-QBMGSDBHNG-MASTER
---
 src/Exception/EmptySoapResponseException.php    | 12 ++++++++++++
 src/Exception/UnexpectedHttpStatusException.php | 12 ++++++++++++
 src/Soap/SoapCurl.php                           |  8 ++++++--
 3 files changed, 30 insertions(+), 2 deletions(-)
 create mode 100644 src/Exception/EmptySoapResponseException.php
 create mode 100644 src/Exception/UnexpectedHttpStatusException.php

diff --git a/src/Exception/EmptySoapResponseException.php b/src/Exception/EmptySoapResponseException.php
new file mode 100644
index 00000000..9b9cd3ff
--- /dev/null
+++ b/src/Exception/EmptySoapResponseException.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace NFePHP\Common\Exception;
+
+class EmptySoapResponseException extends SoapException
+{
+    public static function soapFault($message, $code)
+    {
+        return new static("Erro de comunicação "
+            . "via soap, $message", $code);
+    }
+}
diff --git a/src/Exception/UnexpectedHttpStatusException.php b/src/Exception/UnexpectedHttpStatusException.php
new file mode 100644
index 00000000..27a6ebca
--- /dev/null
+++ b/src/Exception/UnexpectedHttpStatusException.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace NFePHP\Common\Exception;
+
+class UnexpectedHttpStatusException extends SoapException
+{
+    public static function soapFault($message, $code)
+    {
+        return new static("Erro de comunicação "
+            . "via soap,  $message", $code);
+    }
+}
diff --git a/src/Soap/SoapCurl.php b/src/Soap/SoapCurl.php
index 5c196b1b..c2fb48be 100755
--- a/src/Soap/SoapCurl.php
+++ b/src/Soap/SoapCurl.php
@@ -20,6 +20,8 @@
 use NFePHP\Common\Soap\SoapInterface;
 use NFePHP\Common\Exception\SoapException;
 use NFePHP\Common\Exception\TimeoutException;
+use NFePHP\Common\Exception\EmptySoapResponseException;
+use NFePHP\Common\Exception\UnexpectedHttpStatusException;
 use NFePHP\Common\Validator;
 use NFePHP\Common\Certificate;
 
@@ -47,6 +49,8 @@ public function __construct(Certificate $certificate = null)
      * @return string
      * @throws \NFePHP\Common\Exception\SoapException
      * @throws \NFePHP\Common\Exception\TimeoutException
+     * @throws \NFePHP\Common\Exception\EmptySoapResponseException
+     * @throws \NFePHP\Common\Exception\UnexpectedHttpStatusException
      */
     public function send(
         $url,
@@ -151,10 +155,10 @@ public function send(
             } elseif ((int) $httpcode == 500) {
                 $httpcode = 89;
             }
-            throw SoapException::soapFault($msg, $httpcode);
+            throw UnexpectedHttpStatusException::soapFault($msg, $httpcode);
         }
         if (empty($this->responseBody)) {
-            throw SoapException::soapFault('Retorno da SEFAZ VAZIO', 99);
+            throw EmptySoapResponseException::soapFault('Retorno da SEFAZ VAZIO', 99);
         }
         if (!Validator::isXML($this->responseBody)) {
             throw SoapException::soapFault('O retorno não é um XML ' . $this->responseBody, 99);