api

A API do submódulo expõe o endpoint /documentos-de-recebimento/ (basename documentos-de-recebimento), com CRUD completo e ações de análise/correção/atualização/relatório:

• GET /documentos-de-recebimento/ — listagem paginada com filtros (DocumentoDeRecebimentoFilter); fornecedores veem apenas os documentos dos próprios cronogramas.

• POST /documentos-de-recebimento/ — criação pelo fornecedor (UsuarioEhFornecedor); o documento vai para ENVIADO_PARA_ANALISE.

• GET /documentos-de-recebimento/<uuid>/ — detalhe (visão do fornecedor ou da CODAE, conforme o perfil).

• PATCH/DELETE /documentos-de-recebimento/<uuid>/ — atualização e exclusão (exclusão apenas por fornecedor).

• Ações detail=False: dashboard, listagem-relatorio e exportar-excel.

• Ações detail=True: analise-documentos-rascunho, analise-documentos, corrigir-documentos, atualizar-documentos e download-laudo-assinado.

viewsets

class DocumentoDeRecebimentoModelViewSet(**kwargs)

Bases: ViewSetActionPermissionMixin, ModelViewSet

codae_analisa_documentos(request, uuid)

codae_analisa_documentos_rascunho(request, uuid)

dashboard(request)

download_laudo_assinado(request, uuid)

exportar_excel(request, *args, **kwargs)

filter_backends = (<class 'django_filters.rest_framework.backends.DjangoFilterBackend'>,)

filterset_class

alias of DocumentoDeRecebimentoFilter

fornecedor_realiza_atualizacao(request, uuid)

fornecedor_realiza_correcao(request, uuid)

get_queryset()

Get the list of items for this view. This must be an iterable, and may be a queryset. Defaults to using self.queryset.

This method should always be used rather than accessing self.queryset directly, as self.queryset gets evaluated only once, and those results are cached for all subsequent requests.

You may want to override this if you need to provide different querysets depending on the incoming request.

(Eg. return a list of items that is specific to the user)

get_serializer_class()

Return the class to use for the serializer. Defaults to using self.serializer_class.

You may want to override this if you need to provide different serializations depending on the incoming request.

(Eg. admins get full serialization, others get basic serialization)

lista_relatorio(request, *args, **kwargs)

lookup_field = 'uuid'

pagination_class

alias of DefaultPagination

permission_action_classes = {'create': [<class 'src.dados_comuns.permissions.UsuarioEhFornecedor'>], 'delete': [<class 'src.dados_comuns.permissions.UsuarioEhFornecedor'>]}

permission_classes = (<class 'src.dados_comuns.permissions.PermissaoParaVisualizarDocumentosDeRecebimento'>,)

serializer_class

alias of DocumentoDeRecebimentoSerializer

DocumentoDeRecebimentoModelViewSet (ModelViewSet com ViewSetActionPermissionMixin):

• Permissões: leitura/visualização com PermissaoParaVisualizarDocumentosDeRecebimento; create e delete restritos a UsuarioEhFornecedor.

• Queryset dinâmico: usuários fornecedores veem apenas documentos de cronogramas da própria empresa (cronograma__empresa = vinculo_atual.instituicao).

• Serializador dinâmico: list → DocumentoDeRecebimentoSerializer; retrieve → DocRecebimentoDetalharSerializer (fornecedor) ou DocRecebimentoDetalharCodaeSerializer (CODAE); demais ações → DocumentoDeRecebimentoCreateSerializer.

Ações:

• dashboard (GET): painel por status via ServiceDashboardDocumentosDeRecebimento.

• codae_analisa_documentos_rascunho (PATCH analise-documentos-rascunho, UsuarioEhDilogQualidade): salva a análise em rascunho (dados do laudo/laboratório/datas) sem alterar o status.

• codae_analisa_documentos (PATCH analise-documentos, UsuarioEhDilogQualidade): análise final — se houver correcao_solicitada o documento vai para ENVIADO_PARA_CORRECAO (qualidade_solicita_correcao), senão é aprovado (qualidade_aprova_analise).

• fornecedor_realiza_correcao (PATCH corrigir-documentos, UsuarioEhFornecedor): recria os tipos de documento (exigindo ao menos um LAUDO) e chama fornecedor_realiza_correcao (volta para ENVIADO_PARA_ANALISE).

• fornecedor_realiza_atualizacao (PATCH atualizar-documentos, UsuarioEhFornecedor): atualiza os tipos de documento de um documento APROVADO (preservando o LAUDO) e chama fornecedor_atualiza (volta para ENVIADO_PARA_ANALISE).

• download_laudo_assinado (GET download-laudo-assinado): retorna o PDF do laudo assinado; retorna 401 se o documento não estiver APROVADO.

• lista_relatorio (GET listagem-relatorio, PermissaoParaRelatorioDocumentosDeRecebimento): relatório por cronograma com os documentos (filtros CronogramaRelatorioDocumentosFilter e status_documento) e totalizadores (recebidos, pendentes de aprovação, enviados para correção, aprovados).

• exportar_excel (GET exportar-excel, PermissaoParaRelatorioDocumentosDeRecebimento): gera e baixa o relatorio_documentos_recebimento.xlsx com o mesmo queryset do relatório.

filters

class CronogramaRelatorioDocumentosFilter(data=None, queryset=None, *, request=None, prefix=None)

Bases: FilterSet

base_filters = {'empresa': <django_filters.filters.ModelMultipleChoiceFilter object>, 'nome_produto': <django_filters.filters.CharFilter object>, 'numero_cronograma': <django_filters.filters.CharFilter object>}

declared_filters = {'empresa': <django_filters.filters.ModelMultipleChoiceFilter object>, 'nome_produto': <django_filters.filters.CharFilter object>, 'numero_cronograma': <django_filters.filters.CharFilter object>}

class DocumentoDeRecebimentoFilter(data=None, queryset=None, *, request=None, prefix=None)

Bases: FilterSet

base_filters = {'data_cadastro': <django_filters.filters.DateFilter object>, 'nome_fornecedor': <django_filters.filters.CharFilter object>, 'nome_produto': <django_filters.filters.CharFilter object>, 'numero_cronograma': <django_filters.filters.CharFilter object>, 'status': <django_filters.filters.MultipleChoiceFilter object>}

declared_filters = {'data_cadastro': <django_filters.filters.DateFilter object>, 'nome_fornecedor': <django_filters.filters.CharFilter object>, 'nome_produto': <django_filters.filters.CharFilter object>, 'numero_cronograma': <django_filters.filters.CharFilter object>, 'status': <django_filters.filters.MultipleChoiceFilter object>}

DocumentoDeRecebimentoFilter filtra por numero_cronograma, nome_produto, nome_fornecedor (razão social da empresa), status (múltiplo, pelos estados do workflow) e data_cadastro. CronogramaRelatorioDocumentosFilter (usado no relatório) filtra os cronogramas por empresa (uuid), nome_produto e numero_cronograma.

services

class ServiceDashboardDocumentosDeRecebimento(original_queryset, filter_class, serializer_class, request)

Bases: BaseServiceDashboard

STATUS_POR_PERFIL = {'ADMINISTRADOR_CODAE_GABINETE': ['ENVIADO_PARA_ANALISE', 'APROVADO', 'ENVIADO_PARA_CORRECAO'], 'COORDENADOR_CODAE_DILOG_LOGISTICA': ['ENVIADO_PARA_ANALISE', 'APROVADO', 'ENVIADO_PARA_CORRECAO'], 'DILOG_CRONOGRAMA': ['ENVIADO_PARA_ANALISE', 'APROVADO', 'ENVIADO_PARA_CORRECAO'], 'DILOG_DIRETORIA': ['ENVIADO_PARA_ANALISE', 'APROVADO', 'ENVIADO_PARA_CORRECAO'], 'DILOG_QUALIDADE': ['ENVIADO_PARA_ANALISE', 'APROVADO', 'ENVIADO_PARA_CORRECAO']}

ServiceDashboardDocumentosDeRecebimento (herda BaseServiceDashboard) monta o painel de documentos de recebimento: para cada perfil autorizado (DILOG_QUALIDADE, COORDENADOR_CODAE_DILOG_LOGISTICA, DILOG_CRONOGRAMA, ADMINISTRADOR_CODAE_GABINETE e DILOG_DIRETORIA), define os status exibidos (ENVIADO_PARA_ANALISE, APROVADO e ENVIADO_PARA_CORRECAO).

helpers

cria_datas_e_prazos_doc_recebimento(datas_e_prazos, doc_recebimento)

cria_tipos_de_documentos(tipos_de_documentos, documento_de_recebimento=None)

• cria_tipos_de_documentos: cria os TipoDeDocumentoDeRecebimento e seus ArquivoDoTipoDeDocumento a partir do payload (arquivos_do_tipo_de_documento em base64, convertidos para ContentFile).

• cria_datas_e_prazos_doc_recebimento: cria as DataDeFabricaoEPrazo de um documento.

relatorio_documentos_recebimento_excel

gera_relatorio_documentos_recebimento_xlsx(queryset, totalizadores)

Gera o arquivo Excel do Relatório Documentos de Recebimento.

Parameters:

• queryset – QuerySet de Cronograma com documentos_de_recebimento pré-carregados (select_related + prefetch_related).

• totalizadores – Dict com os totalizadores dos cards.

Returns:

Conteúdo do arquivo .xlsx.

Return type:

bytes

Geração do Excel do Relatório de Documentos de Recebimento (gera_relatorio_documentos_recebimento_xlsx). O relatório tem 20 colunas (cronograma, produto, empresa, pregão, processo SEI, laudo, status, laboratório, datas de fabricação/validade, lotes, datas, unidade, quantidades e saldos do laudo, observações e solicitação de correção), com sanitização contra injeção de fórmulas e formatação numérica das quantidades/saldos.

serializers

class ArquivoDoTipoDeDocumentoLookupSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

exclude = ('id', 'uuid', 'tipo_de_documento')

model

alias of ArquivoDoTipoDeDocumento

class CronogramaRelatorioDocumentosSerializer(*args, **kwargs)

Bases: Serializer

get_documentos(obj)

get_numero_pregao_chamada_publica(obj)

class DataDeFabricacaoEPrazoLookupSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

exclude = ('id', 'documento_recebimento')

model

alias of DataDeFabricaoEPrazo

class DocRecebimentoDetalharCodaeSerializer(*args, **kwargs)

Bases: DocRecebimentoDetalharSerializer

class Meta

Bases: Meta

fields = ('uuid', 'numero_cronograma', 'pregao_chamada_publica', 'nome_produto', 'numero_laudo', 'status', 'criado_em', 'tipos_de_documentos', 'correcao_solicitada', 'logs', 'programa_leve_leite', 'fornecedor', 'numero_sei', 'laboratorio', 'quantidade_laudo', 'unidade_medida', 'saldo_laudo', 'numero_lote_laudo', 'data_final_lote', 'datas_fabricacao_e_prazos', 'correcao_solicitada')

get_fornecedor(obj)

get_numero_sei(obj)

get_saldo_laudo(obj)

class DocRecebimentoDetalharSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('uuid', 'numero_cronograma', 'pregao_chamada_publica', 'nome_produto', 'numero_laudo', 'status', 'criado_em', 'tipos_de_documentos', 'correcao_solicitada', 'logs', 'programa_leve_leite')

model

alias of DocumentoDeRecebimento

get_criado_em(obj)

get_nome_produto(obj)

get_numero_cronograma(obj)

get_pregao_chamada_publica(obj)

get_programa_leve_leite(obj)

class DocRecebimentoFichaDeRecebimentoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('uuid', 'numero_laudo', 'numero_lote_laudo', 'datas_fabricacao', 'datas_validade', 'saldo_laudo', 'quantidade_recebida')

model

alias of DocumentoDeRecebimento

get_datas_fabricacao(obj)

get_datas_validade(obj)

get_quantidade_recebida(obj)

get_saldo_laudo(obj)

class DocumentoDeRecebimentoDetalheRelatorioSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('uuid', 'numero_laudo', 'nome_laboratorio', 'numero_lote_laudo', 'data_final_lote', 'unidade_medida', 'quantidade_laudo', 'saldo_inicial_laudo', 'saldo_atual', 'datas_fabricacao_e_prazos', 'status_documento')

model

alias of DocumentoDeRecebimento

get_saldo_atual(obj)

class DocumentoDeRecebimentoParaAjusteSaldoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('uuid', 'numero_laudo', 'unidade_medida', 'quantidade_laudo', 'saldo_atual')

model

alias of DocumentoDeRecebimento

get_saldo_atual(obj)

class DocumentoDeRecebimentoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('uuid', 'numero_cronograma', 'numero_laudo', 'pregao_chamada_publica', 'nome_produto', 'programa_leve_leite', 'status', 'criado_em')

model

alias of DocumentoDeRecebimento

get_criado_em(obj)

get_nome_produto(obj)

get_numero_cronograma(obj)

get_pregao_chamada_publica(obj)

get_programa_leve_leite(obj)

class PainelDocumentoDeRecebimentoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('uuid', 'numero_cronograma', 'nome_produto', 'nome_empresa', 'status', 'log_mais_recente', 'programa_leve_leite')

model

alias of DocumentoDeRecebimento

get_log_mais_recente(obj)

get_nome_empresa(obj)

get_nome_produto(obj)

get_programa_leve_leite(obj)

class TipoDocumentoDeRecebimentoLookupSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

exclude = ('id', 'documento_recebimento')

model

alias of TipoDeDocumentoDeRecebimento

calcular_saldo_laudo(documento_recebimento)

Serializadores de saída:

• calcular_saldo_laudo: função que calcula o saldo do laudo (quantidade_laudo − total recebido em fichas assinadas − ajustes de saldo).

• DocRecebimentoFichaDeRecebimentoSerializer: dados do documento na ficha de recebimento (datas de fabricação/validade, quantidade recebida e saldo do laudo).

• DocumentoDeRecebimentoSerializer: linha da listagem (cronograma, pregão, produto, programa_leve_leite, status e data de cadastro).

• PainelDocumentoDeRecebimentoSerializer: linha do dashboard (produto, empresa, status, log mais recente).

• ArquivoDoTipoDeDocumentoLookupSerializer / TipoDocumentoDeRecebimentoLookupSerializer: arquivos e tipos com seus arquivos aninhados.

• DocRecebimentoDetalharSerializer: detalhe para o fornecedor (tipos de documento, logs, correção solicitada).

• DocRecebimentoDetalharCodaeSerializer: detalhe para a CODAE (com laboratório, unidade de medida, datas de fabricação/prazos, número SEI, fornecedor e saldo do laudo).

• DocumentoDeRecebimentoDetalheRelatorioSerializer: linha do relatório (laboratório, unidade, quantidades, saldos, datas e status).

• CronogramaRelatorioDocumentosSerializer: cronograma do relatório com os documentos aninhados.

• DocumentoDeRecebimentoParaAjusteSaldoSerializer: dados para o ajuste de saldo do laudo (unidade, quantidade e saldo atual).

serializer_create

class DataDeFabricaoEPrazoAnalisarRascunhoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('data_fabricacao', 'data_validade', 'prazo_maximo_recebimento', 'justificativa')

model

alias of DataDeFabricaoEPrazo

class DataDeFabricaoEPrazoAnalisarSerializer(*args, **kwargs)

Bases: DataDeFabricaoEPrazoAnalisarRascunhoSerializer

class Meta

Bases: Meta

extra_kwargs = {'data_fabricacao': {'allow_null': False, 'required': True}, 'data_validade': {'allow_null': False, 'required': True}, 'prazo_maximo_recebimento': {'allow_blank': False, 'required': True}}

validate(attrs)

class DocumentoDeRecebimentoAnalisarRascunhoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('laboratorio', 'quantidade_laudo', 'unidade_medida', 'numero_lote_laudo', 'data_final_lote', 'datas_fabricacao_e_prazos')

model

alias of DocumentoDeRecebimento

update(instance, validated_data)

class DocumentoDeRecebimentoAnalisarSerializer(*args, **kwargs)

Bases: CamposObrigatoriosMixin, DocumentoDeRecebimentoAnalisarRascunhoSerializer

class Meta

Bases: Meta

fields = ('laboratorio', 'quantidade_laudo', 'unidade_medida', 'numero_lote_laudo', 'data_final_lote', 'datas_fabricacao_e_prazos', 'correcao_solicitada')

update(instance, validated_data)

class DocumentoDeRecebimentoAtualizacaoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('tipos_de_documentos',)

model

alias of DocumentoDeRecebimento

update(instance, validated_data)

class DocumentoDeRecebimentoCorrecaoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('tipos_de_documentos',)

model

alias of DocumentoDeRecebimento

update(instance, validated_data)

validate(attrs)

class DocumentoDeRecebimentoCreateSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

exclude = ('id',)

model

alias of DocumentoDeRecebimento

create(validated_data)

Cria o documento de recebimento para o cronograma informado, cria os tipos de documento (helper) e inicia o fluxo (o documento passa para ENVIADO_PARA_ANALISE).

validate_cronograma(value)

class TipoDeDocumentoDeRecebimentoCorrecaoSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

fields = ('tipo_documento', 'descricao_documento', 'arquivos_do_tipo_de_documento')

model

alias of TipoDeDocumentoDeRecebimento

validate(attrs)

class TipoDeDocumentoDeRecebimentoCreateSerializer(*args, **kwargs)

Bases: ModelSerializer

class Meta

Bases: object

exclude = ('id', 'documento_recebimento')

model

alias of TipoDeDocumentoDeRecebimento

validate(attrs)

Serializadores de entrada:

• TipoDeDocumentoDeRecebimentoCreateSerializer: tipo do documento com arquivos_do_tipo_de_documento (JSON, write-only); quando o tipo é LAUDO, exige arquivo e nome em cada arquivo.

• DocumentoDeRecebimentoCreateSerializer: criação pelo fornecedor — cronograma (uuid) e numero_laudo obrigatórios; cria os tipos de documento (helper) e chama inicia_fluxo (o documento vai para ENVIADO_PARA_ANALISE).

• DataDeFabricaoEPrazoAnalisarRascunhoSerializer: dados de fabricação/prazo em rascunho (todos opcionais).

• DataDeFabricaoEPrazoAnalisarSerializer: versão da análise final — data_fabricacao, data_validade e prazo_maximo_recebimento obrigatórios; quando o prazo é OUTRO, exige justificativa.

• DocumentoDeRecebimentoAnalisarRascunhoSerializer: análise em rascunho (laboratório, unidade, quantidade, lote, data final e datas/prazos) — não altera o status.

• DocumentoDeRecebimentoAnalisarSerializer (herda CamposObrigatóriosMixin): análise final da CODAE. O campo correcao_solicitada é opcional; quando preenchido, todos os demais campos tornam-se opcionais e o documento é enviado para correção (qualidade_solicita_correcao); caso contrário, é aprovado (qualidade_aprova_analise).

• TipoDeDocumentoDeRecebimentoCorrecaoSerializer: tipo de documento na correção — OUTROS exige descricao_documento; todo arquivo exige arquivo e nome.

• DocumentoDeRecebimentoCorrecaoSerializer: correção do fornecedor — exige ao menos um tipo LAUDO; apaga os tipos antigos (com seus arquivos), recria os novos e chama fornecedor_realiza_correcao.

• DocumentoDeRecebimentoAtualizacaoSerializer: atualização de documento aprovado pelo fornecedor — recria os tipos (exceto o LAUDO) e chama fornecedor_atualiza.