Table of Contents

IncidentReports

Endpoints relacionados con los reportes de siniestro.

Los reportes de siniestro pueden ser del siguiente tipo:

  • Reportado por el taller
  • Reportado por el asegurado

Endpoint Método Descripción
/incidentReports/ POST Recibe un reporte de siniestro de infopiezas.net

POST /incidentReports

Recibe un reporte de siniestro y lo registra en el sistema de la aseguradora. Se recibe un objeto en el body del mensaje con los datos del reporte.

Estructura

Ejemplo de estructura:

 {
    "incidentReportFormId": 0,
    "incidentReportFormGuid": "string",
    "incidentReportFormStatusId": 0,
    "incidentReportStatusName": "string",
    "incidentReportCategoryId": 0,
    "incidentReportCategoryName": "string",
    "insurancePerson": {
      "personId": 0,
      "personTaxId": "string",
      "personName": "string"
    },
    "createdByPerson": {
      "personId": 0,
      "personTaxId": "string",
      "personName": "string"
    },
    "createdByDisplayName": "string",
    "workshopPerson": {
      "personId": 0,
      "personTaxId": "string",
      "personName": "string"
    },
    "createdOnUtc": "2024-06-27T02:44:26.482Z",
    "createdOnLocal": "2024-06-27T02:44:26.482Z",
    "stateId": 0,
    "stateName": "string",
    "stateCityId": 0,
    "stateCityName": "string",
    "generalInfo": {
      "incidentReportTypeId": 0,
      "incidentReportTypeName": "string",
      "incidentDateTime": "2024-06-27T02:44:26.482Z",
      "insurancePolicyNumber": "string",
      "insuranceOwnerDisplayName": "string",
      "vinNumber": "string",
      "vehicleMakeId": 0,
      "vehicleMakeName": "string",
      "vehicleModelId": 0,
      "vehicleModelName": "string",
      "vehicleYear": 0,
      "stateId": 0,
      "stateName": "string",
      "stateCityId": 0,
      "stateCityName": "string",
      "workshopPersonId": 0
    },
    "reportedAuthorities": [
      {
        "authorityId": 0,
        "authorityName": "string"
      }
    ],
    "insuranceFormInfoJson": "string",
    "items": [
      {
        "itemId": 0,
        "quantity": 0,
        "itemCode": "string",
        "itemName": "string",
        "itemActionId": 0,
        "itemActionName": "string",
        "itemRepairPrice": 0,
        "itemReplacePrice": 0,
        "itemMinSellPrice": 0,
        "itemAverageSellPrice": 0,
        "itemMaxSellPrice": 0
      }
    ],
    "services": [
      {
        "workshopServiceId": 0,
        "quantity": 0,
        "workshopServiceCode": "string",
        "workshopServiceName": "string",
        "unitPrice": 0
      }
    ],
    "attachmentsDocuments": [
      {
        "sequenceIndex": 0,
        "incidentReportFormAttachmentId": 0,
        "incidentDocumentTypeId": 0,
        "incidentDocumentTypeName": "string",
        "originalFilename": "string",
        "hasPreview": true,
        "filename": "string",
        "previewFilename": "string",
        "baseUrl": "string",
        "fileFullPath": "string",
        "previewFullPath": "string"
      }
    ],
    "attachmentsPictures": [
      {
        "sequenceIndex": 0,
        "incidentReportFormAttachmentId": 0,
        "incidentDocumentTypeId": 0,
        "incidentDocumentTypeName": "string",
        "originalFilename": "string",
        "hasPreview": true,
        "filename": "string",
        "previewFilename": "string",
        "baseUrl": "string",
        "fileFullPath": "string",
        "previewFullPath": "string"
      }
    ],
    "reportFormContents": {}
  }
 

IncidentReportModel

Atributo Tipo de datos Descripción
IncidentReportFormId int Id del formulario
IncidentReportFormGuid Guid Guid del formulario
IncidentReportFormStatusId short Id estatus del siniestro
IncidentReportStatusName string Nombre del estatus del siniestro
IncidentReportCategoryId short Id de categoría
IncidentReportCategoryName string Nombre categoría del siniestro
InsurancePerson PersonDetails Datos de la compañía aseguradora
CreatedByPerson PersonDetails Datos de la compañía que creó el reporte
CreatedByDisplayName string Nombre del usuario que creó el reporte
WorkshopPerson PersonDetails Datos del taller
CreatedOnUtc DateTime Fecha de creación del reporte en UTC
CreatedOnLocal DateTime Fecha de creación del reporte en hora local
StateId int? Id de la provincia
StateName string Nombre de la provincia
StateCityId int? Id de la ciudad
StateCityName string Nombre de la ciudad
GeneralInfo GeneralInfoDetails Datos generales
ReportedAuthorities List Autoridades reportadas
InsuranceFormInfoJson string Datos del formulario del asegurador
Items List Piezas
Services List Servicios
AttachmentsDocuments List Documentos anexos
AttachmentsPictures List Fotografías del vehículo asegurado
reportFormContents Objeto Detalle del formulario de siniestro

PersonDetails

Atributo Tipo de datos Descripción
PersonId int Id de la empresa en infopiezas
PersonTaxId string RNC de la empresa
PersonName string Nombre de la empresa

GeneralInfoDetails

Atributo Tipo de datos Descripción
IncidentReportTypeId short? Id tipo de siniestro
IncidentReportTypeName string? Nombre tipo de siniestro
IncidentDateTime DateTime Fecha siniestro en tiempo local
InsurancePolicyNumber string Número de póliza
InsuranceOwnerDisplayName string Nombre del asegurado
VinNumber string Número de chassis
VehicleMakeId int? Id de marca del vehículo asegurado
VehicleMakeName string Marca del vehículo asegurado
VehicleModelId int? Id de modelo del vehículo asegurado
VehicleModelName string Modelo del vehículo asegurado
VehicleYear short Año del vehículo asegurado
StateId int? Id de provincia del siniestro
StateName string Provincia del siniestro
StateCityId int? Id de ciudad del siniestro
StateCityName string Ciudad del siniestro
WorkshopPersonId int? Id del taller

ServiceItemDetails

Atributo Tipo de datos Descripción
WorkshopServiceId int Id taller que brinda otros servicios
Quantity decimal Cantidad del servicio
WorkshopServiceCode string Código de referencia de servicio en el taller
WorkshopServiceName string Nombre de servicio en el taller
UnitPrice decimal Precio por unidad

ItemDetails

Atributo Tipo de datos Descripción
ItemId int Id de pieza
Quantity short Cantidad
ItemCode string Código de referencia
ItemName string Nombre de la pieza
ItemActionId short Id acción a tomar para la pieza
ItemActionName string Acción a tomar para la pieza
ItemRepairPrice decimal Costo de reparación de la pieza
ItemReplacePrice decimal Costo de reemplazo de la pieza
ItemMinSellPrice decimal Precio mínimo de la pieza
ItemAverageSellPrice decimal Precio promedio de la pieza
ItemMaxSellPrice decimal Precio máximo de la pieza

ReportedAuthorityDetails

Atributo Tipo de datos Descripción
AuthorityId int? Id de la autoridad
AuthorityName string? Nombre de la autoridad

AttachmentDetails

Atributo Tipo de datos Descripción
IncidentReportFormAttachmentId int Id del anexo
IncidentDocumentTypeId int Id de tipo de anexo
IncidentDocumentTypeName string Tipo de anexo
OriginalFilename string Nombre de archivo original
HasPreview bool Si tiene vista previa
ContentType string Content type del documento (Para más información ver http://en.wikipedia.org/wiki/Internet_media_type)
Filename string Nombre del archivo actual
PreviewFilename string Nombre del archivo de vista previa actual
BaseUrl string URL base del anexo
FileFullPath string Ruta completa del archivo
PreviewFullPath string Ruta completa de la vista previa

PicturesDetails

Atributo Tipo de datos Descripción
IncidentReportFormAttachmentId int Id del anexo
IncidentDocumentTypeId int Id de tipo de anexo
IncidentDocumentTypeName string Tipo de anexo
OriginalFilename string Nombre de archivo original
HasPreview bool Si tiene vista previa
ContentType string Content type del documento (Para más información ver http://en.wikipedia.org/wiki/Internet_media_type)
Filename string Nombre del archivo actual
PreviewFilename string Nombre del archivo de vista previa actual
BaseUrl string URL base del anexo
FileFullPath string Ruta completa del archivo
PreviewFullPath string Ruta completa de la vista previa
classDiagram
 
    class IncidentReportModel {
        int IncidentReportFormId
        Guid IncidentReportFormGuid
        short IncidentReportFormStatusId
        string IncidentReportStatusName
        short IncidentReportCategoryId
        string IncidentReportCategoryName
        PersonDetails InsurancePerson
        PersonDetails CreatedByPerson
        string CreatedByDisplayName
        PersonDetails WorkshopPerson
        DateTime CreatedOnUtc
        DateTime CreatedOnLocal
        int? StateId
        string StateName
        int? StateCityId
        string StateCityName
        GeneralInfoDetails GeneralInfo
        List~ReportedAuthorityDetails~ ReportedAuthorities
        string InsuranceFormInfoJson
        List~ItemDetails~ Items
        List~ServiceItemDetails~ Services
        List~AttachmentDetails~ AttachmentsDocuments
        List~PicturesDetails~ AttachmentsPictures
    }

    class PersonDetails {
        int PersonId
        string PersonTaxId
        string PersonName
    }

    class GeneralInfoDetails {
        short? IncidentReportTypeId
        string? IncidentReportTypeName
        DateTime IncidentDateTime
        string InsurancePolicyNumber
        string InsuranceOwnerDisplayName
        string VinNumber
        int? VehicleMakeId
        string VehicleMakeName
        int? VehicleModelId
        string VehicleModelName
        short VehicleYear
        int? StateId
        string StateName
        int? StateCityId
        string StateCityName
        int? WorkshopPersonId
    }

    class ServiceItemDetails {
        int WorkshopServiceId
        decimal Quantity
        string WorkshopServiceCode
        string WorkshopServiceName
        decimal UnitPrice
    }

    class ItemDetails {
        int ItemId
        short Quantity
        string ItemCode
        string ItemName
        short ItemActionId
        string ItemActionName
        decimal ItemRepairPrice
        decimal ItemReplacePrice
        decimal ItemMinSellPrice
        decimal ItemAverageSellPrice
        decimal ItemMaxSellPrice
    }

    class ReportedAuthorityDetails {
        int? AuthorityId
        string? AuthorityName
    }

    class AttachmentDetails {
        int SequenceIndex
        int IncidentReportFormAttachmentId
        int IncidentDocumentTypeId
        string IncidentDocumentTypeName
        string OriginalFilename
        bool HasPreview
        string Filename
        string PreviewFilename
        string BaseUrl
        string FileFullPath
        string PreviewFullPath        
    }

    class PicturesDetails {
        int SequenceIndex
        int IncidentReportFormAttachmentId
        int IncidentDocumentTypeId
        string IncidentDocumentTypeName
        string OriginalFilename
        bool HasPreview
        string Filename
        string PreviewFilename
        string BaseUrl
        string FileFullPath
        string PreviewFullPath        
    }

    IncidentReportModel --> "1" PersonDetails
    IncidentReportModel --> "1" GeneralInfoDetails
    IncidentReportModel --> "n" ReportedAuthorityDetails
    IncidentReportModel --> "n" ItemDetails
    IncidentReportModel --> "n" ServiceItemDetails
    IncidentReportModel --> "n" AttachmentDetails
    IncidentReportModel --> "n" PicturesDetails



Ejemplo

{
    "incidentReportFormId": 67,
    "incidentReportFormGuid": "a61dcf87-e463-4526-9619-eed3246beb5f",
    "incidentReportFormStatusId": 1,
    "incidentReportStatusName": "Borrador",
    "incidentReportCategoryId": 1,
    "incidentReportCategoryName": "Taller/intermediario",
    "insurancePerson": {
      "personId": 1045,
      "personTaxId": "101384048",
      "personName": "Seguros ABC"
    },
    "createdByPerson": {
      "personId": 2299,
      "personTaxId": "105197714",
      "personName": "Pinturas de vehículos, SRL"
    },
    "createdByDisplayName": "Daniel Encarnación",
    "workshopPerson": {
      "personId": 2299,
      "personTaxId": "105197714",
      "personName": "Pinturas de vehículos, SRL"
    },
    "createdOnUtc": "2024-06-27T02:29:41.72",
    "createdOnLocal": "2024-06-26T22:29:41.72",
    "stateId": 1,
    "stateName": "Distrito Nacional",
    "stateCityId": 4,
    "stateCityName": "Distrito Nacional",
    "generalInfo": {
      "incidentReportTypeId": null,
      "incidentReportTypeName": null,
      "incidentDateTime": "2024-04-02T11:00:00",
      "insurancePolicyNumber": "1231",
      "insuranceOwnerDisplayName": "Empresas XYZ, SRL",
      "vinNumber": "5FNYF4H90BB040110",
      "vehicleMakeId": 4,
      "vehicleMakeName": "BMW",
      "vehicleModelId": 545,
      "vehicleModelName": "X5",
      "vehicleYear": 2022,
      "stateId": 1,
      "stateName": "Distrito Nacional",
      "stateCityId": 4,
      "stateCityName": "Distrito Nacional",
      "workshopPersonId": 2299
    },
    "reportedAuthorities": [
      {
        "authorityId": 1,
        "authorityName": "Policía Nacional"
      },
      {
        "authorityId": 2,
        "authorityName": "DIGESETT"
      }
    ],
    "items": [
      {
        "itemId": 102234,
        "quantity": 1,
        "itemCode": null,
        "itemName": "FAROL BUMPER DELANTERO IZQUIERDO",
        "itemActionId": 1,
        "itemActionName": "Cambiar",
        "itemRepairPrice": 0,
        "itemReplacePrice": 0,
        "itemMinSellPrice": 0,
        "itemAverageSellPrice": 0,
        "itemMaxSellPrice": 0
      },
      {
        "itemId": 102545,
        "quantity": 1,
        "itemCode": null,
        "itemName": "PUERTA DELANTERA IZQUIERA",
        "itemActionId": 2,
        "itemActionName": "Reparar",
        "itemRepairPrice": 0,
        "itemReplacePrice": 0,
        "itemMinSellPrice": 0,
        "itemAverageSellPrice": 0,
        "itemMaxSellPrice": 0
      },
      {
        "itemId": 101876,
        "quantity": 1,
        "itemCode": null,
        "itemName": "BONETE",
        "itemActionId": 2,
        "itemActionName": "Reparar",
        "itemRepairPrice": 0,
        "itemReplacePrice": 0,
        "itemMinSellPrice": 0,
        "itemAverageSellPrice": 0,
        "itemMaxSellPrice": 0
      }
    ],
    "services": [
      {
        "workshopServiceId": 2,
        "quantity": 4.00,
        "workshopServiceCode": "101",
        "workshopServiceName": "Alineación",
        "unitPrice": 0
      },
      {
        "workshopServiceId": 1,
        "quantity": 2.00,
        "workshopServiceCode": "100",
        "workshopServiceName": "Pintura",
        "unitPrice": 0
      }
    ],
    "attachmentsDocuments": [
      {
        "incidentReportFormAttachmentId": 33,
        "incidentDocumentTypeId": 3,
        "incidentDocumentTypeName": "Acta policial",
        "originalFilename": "incidents/3cacd69bed484919a8da9fef716ac273.png",
        "hasPreview": true,
        "filename": "incidents/3cacd69bed484919a8da9fef716ac273.png",
        "contentType": "image/jpeg",
        "previewFilename": "incidents/3cacd69bed484919a8da9fef716ac273_preview.png",
        "baseUrl": "https://infopiezasmediatest.blob.core.windows.net/incidentreports",
        "fileFullPath": "https://infopiezasmediatest.blob.core.windows.net/incidentreports/incidents/3cacd69bed484919a8da9fef716ac273.png",
        "previewFullPath": "https://infopiezasmediatest.blob.core.windows.net/incidentreports/incidents/3cacd69bed484919a8da9fef716ac273_preview.png"
      }
    ],
    "attachmentsPictures": [
      {
        "incidentReportFormAttachmentId": 32,
        "incidentDocumentTypeId": 1,
        "incidentDocumentTypeName": "Fotografía del vehículo",
        "originalFilename": "incidents/f7c483fa9e81442784f23ad6cd065d22.jpg",
        "hasPreview": true,
        "filename": "incidents/f7c483fa9e81442784f23ad6cd065d22.jpg",
        "contentType": "image/jpeg",        
        "previewFilename": "incidents/f7c483fa9e81442784f23ad6cd065d22_preview.jpg",
        "baseUrl": "https://infopiezasmediatest.blob.core.windows.net/incidentreports",
        "fileFullPath": "https://infopiezasmediatest.blob.core.windows.net/incidentreports/incidents/f7c483fa9e81442784f23ad6cd065d22.jpg",
        "previewFullPath": "https://infopiezasmediatest.blob.core.windows.net/incidentreports/incidents/f7c483fa9e81442784f23ad6cd065d22_preview.jpg"
      }
    ],
    "reportFormContents": {},
  }
Note

Los documentos JSON que aparecen aquí son solamente para fines ilustrativos y no necesariamente representa la última versión del objeto en el API. Se debe utilizar como referencia de desarrollo siempre el JSON que aparece en la documentación dinámica del endpoint correspondiente en Swagger.


Respuesta

Se devuelve un objeto que incluye el número del reporte de siniestro en el sistema de la aseguradora.

classDiagram
    class CreatedIncidentReportResponse {
        IncidentReportFormId: int
        InternalIncidentReportId: string
    }
  {
    "incidentReportFormId": 0,
    "internalIncidentReportId": "string"
  }

Note

Los documentos JSON que aparecen aquí son solamente para fines ilustrativos y no necesariamente representa la última versión del objeto en el API. Se debe utilizar como referencia de desarrollo siempre el JSON que aparece en la documentación dinámica del endpoint correspondiente en Swagger.