← InicioFleetPay / Schema

Mdfe

Estructura preservada del contrato versionado de la API.

Las descripciones técnicas se traducen del contrato versionado. Se conservan los identificadores y el JSON originales; se omiten los ejemplos de datos.

FiscalRoute ↗MdfeStatus ↗Vehicle ↗

idstring · uuidObligatorio

UUID público utilizado en todas las rutas del MDF-e.

statusobjectObligatorio

MdfeStatus ↗

vehicleobjectObligatorio

Vehicle ↗

driver_idinteger | nullObligatorio

trailersarrayObligatorio

Vehicle ↗

route—Obligatorio

FiscalRoute ↗

cte_idsarrayObligatorio

UUID públicos de los CT-e autorizados cubiertos por el MDF-e.

numberinteger | nullObligatorio

seriesstring | nullObligatorio

access_keystring | nullObligatorio

pattern"^\\d{44}$"

protocolstring | nullObligatorio

sefaz_protocolstring | nullObligatorio

cstatstring | nullObligatorio

reasonstring | nullObligatorio

authorized_atstring | null · date-timeObligatorio

closed_atstring | null · dateObligatorio

closing_protocolstring | nullObligatorio

payloadobjectObligatorio

additionalPropertiestrue

created_atstring | null · date-timeObligatorio

updated_atstring | null · date-timeObligatorio

Definición JSON Original (Descripciones en Portugués)

{
  "type": "object",
  "required": [
    "id",
    "status",
    "vehicle",
    "driver_id",
    "trailers",
    "route",
    "cte_ids",
    "number",
    "series",
    "access_key",
    "protocol",
    "sefaz_protocol",
    "cstat",
    "reason",
    "authorized_at",
    "closed_at",
    "closing_protocol",
    "payload",
    "created_at",
    "updated_at"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "description": "UUID público usado em todos os caminhos do MDF-e."
    },
    "status": {
      "$ref": "#/components/schemas/MdfeStatus"
    },
    "vehicle": {
      "$ref": "#/components/schemas/Vehicle"
    },
    "driver_id": {
      "type": [
        "integer",
        "null"
      ]
    },
    "trailers": {
      "type": "array",
      "items": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Vehicle"
          },
          {
            "type": "object",
            "required": [
              "position"
            ],
            "properties": {
              "position": {
                "type": "integer",
                "minimum": 1,
                "maximum": 3
              }
            }
          }
        ]
      }
    },
    "route": {
      "allOf": [
        {
          "$ref": "#/components/schemas/FiscalRoute"
        },
        {
          "type": "object",
          "required": [
            "starts_at",
            "ends_at"
          ],
          "properties": {
            "starts_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "ends_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            }
          }
        }
      ]
    },
    "cte_ids": {
      "type": "array",
      "description": "UUIDs públicos dos CT-e autorizados cobertos pelo MDF-e.",
      "items": {
        "type": "string",
        "format": "uuid"
      }
    },
    "number": {
      "type": [
        "integer",
        "null"
      ]
    },
    "series": {
      "type": [
        "string",
        "null"
      ]
    },
    "access_key": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^\\d{44}$"
    },
    "protocol": {
      "type": [
        "string",
        "null"
      ]
    },
    "sefaz_protocol": {
      "type": [
        "string",
        "null"
      ]
    },
    "cstat": {
      "type": [
        "string",
        "null"
      ]
    },
    "reason": {
      "type": [
        "string",
        "null"
      ]
    },
    "authorized_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "closed_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "closing_protocol": {
      "type": [
        "string",
        "null"
      ]
    },
    "payload": {
      "type": "object",
      "additionalProperties": true
    },
    "created_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    }
  }
}