🚧
What's New in bizAPIs 3.0
Enhanced Error Responses with bizAPIs Status Codes
bizAPIs 3.0 introduces structured error responses with dedicated bizAPIs status codes, making debugging faster and support interactions more efficient. All error responses now include detailed metadata like requestId, errorCode, and errorName to help you quickly identify and resolve issues.
Availability by Environment
Environment Status
📚 Documentation ✅ Available
🧪 QUAL ✅ Available
🚀 Production ⏳ Coming Soon
Learn more about error handling →

💻

DOWNLOAD PROJECT

Java

Python

C#

To watch the video click here

JSON Schema for API Response

{
  "type" : "object",
  "properties" : {
    "RequestId" : {
      "type" : "string"
    },
    "Posicao Integrada" : {
      "type" : "array",
      "description" : "Informações consolidadas sobre a posição integrada do contribuinte junto à Autoridade Tributária.",
      "items" : {
        "type" : "object",
        "properties" : {
          "title" : {
            "type" : "string",
            "description" : "O título que representa o item fiscal específico."
          },
          "status" : {
            "type" : "string",
            "description" : "O estado atual do item. 'Verde' significa 'cumprimento', 'Amarelo' significa 'em progresso' e 'Vermelho' significa 'incumprimento'."
          }
        }
      }
    },
    "Alertas" : {
      "type" : "array",
      "description" : "Lista de alertas emitidos pela Autoridade Tributária. Pode incluir prazos de pagamento, avisos de irregularidades ou necessidade de submissão de declarações.",
      "items" : {
        "type" : "object",
        "properties" : {
          "descriptionName" : {
            "type" : "string",
            "description" : "O nome ou categoria do alerta."
          },
          "description" : {
            "type" : "string",
            "description" : "Uma explicação detalhada sobre o alerta."
          },
          "limitDate" : {
            "type" : "string",
            "description" : "O prazo ou data em que a ação associada ao alerta deve ser concluída, no formato 'YYYY-MM-DD'."
          }
        }
      }
    },
    "Interacoes" : {
      "type" : "array",
      "description" : "Registro de interações entre o contribuinte e a Autoridade Tributária, incluindo submissões, pedidos de informação e respostas da AT.",
      "items" : {
        "type" : "object",
        "properties" : {
          "tax" : {
            "type" : "string",
            "description" : "O tipo de imposto ou item fiscal relacionado com esta interação."
          },
          "description" : {
            "type" : "string",
            "description" : "Uma descrição detalhada da interação, como o propósito ou contexto."
          },
          "date" : {
            "type" : "string",
            "description" : "A data em que a interação ocorreu, no formato 'YYYY-MM-DD'."
          }
        }
      }
    }
  }
}

{
  "type": "object",
  "properties": {
    "RequestId": {
      "type": "string"
    },
    "Posicao Integrada": {
      "type": "array",
      "description": "Consolidated information about the taxpayer's fiscal position with the Tax Authority.",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "The title or header representing the specific tax-related item."
          },
          "status": {
            "type": "string",
            "description": "The current status of the item. 'Green' means 'in compliance', 'Yellow' means 'in progress', and 'Red' means 'non-compliance'."
          }
        }
      }
    },
    "Alertas": {
      "type": "array",
      "description": "List of alerts issued by the Tax Authority. May include payment deadlines, irregularity notices, or the need to submit declarations.",
      "items": {
        "type": "object",
        "properties": {
          "descriptionName": {
            "type": "string",
            "description": "The name or category of the alert."
          },
          "description": {
            "type": "string",
            "description": "A detailed explanation of the alert."
          },
          "limitDate": {
            "type": "string",
            "description": "The deadline or date by which the action associated with this alert must be taken, formatted as 'YYYY-MM-DD'."
          }
        }
      }
    },
    "Interacoes": {
      "type": "array",
      "description": "Record of interactions between the taxpayer and the Tax Authority, including submissions, information requests, and responses from the Tax Authority.",
      "items": {
        "type": "object",
        "properties": {
          "tax": {
            "type": "string",
            "description": "The type of tax or fiscal item related to this interaction."
          },
          "description": {
            "type": "string",
            "description": "A detailed description of the interaction, such as the purpose or context."
          },
          "date": {
            "type": "string",
            "description": "The date when the interaction occurred, formatted as 'YYYY-MM-DD'."
          }
        }
      }
    }
  }
}

Best Practices

Always log the requestId - Include it when contacting support for faster issue resolution
Use errorCode or errorName for programmatic error handling in your application
Reference the timestamp for correlating errors with your application logs

📖 View complete error codes reference →

200200

401401

503503